> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 騰訊雲人臉能力

> 配置騰訊雲人臉能力，爲應用接入人臉識別、活體檢測和實名覈驗等功能。

## 這是什麼

「騰訊雲人臉能力」是基於騰訊雲的人臉識別插件，支持兩種場景：

* **FaceID（人臉核身）**：適用於實名覈驗、活體核身、KYC 等"確認是不是本人"的場景。
* **IAI（人臉識別）**：適用於照片人臉檢測、比對、搜索等"識別圖片中人臉"的場景。

插件按項目獨立啓用。啓用後請在詳情頁配置騰訊雲密鑰和參數。

***

## 入口位置

1. 進入任意項目。
2. 頂部切換到 **「研發」** Tab。
3. 左側導航選擇 **「技能庫」**。
4. 在卡片列表中找到 **「騰訊雲人臉能力」**。

***

## 啓用

以下任一方式都可以啓用：

* 在技能庫卡片上懸停，點擊 **「使用」**。
* 打開插件詳情頁，在頭部點擊 **「使用」**。
* 當 AI 在對話中主動彈出插件啓用卡片時，點擊確認。

啓用後，請在插件詳情頁配置密鑰。

***

## 配置

啓用後進入插件詳情頁。

### 必填

* **SecretId**：騰訊雲 API 密鑰 ID，從 CAM 訪問密鑰管理獲取。
* **SecretKey**：騰訊雲 API 密鑰，請妥善保管，不要泄漏到公開環境或前端源碼。

這兩項必須同時填寫或同時留空。

### 選填

* **默認模式**：人臉核身默認模式，例如 `liveness_recognition` 用於活體核身，按實際場景填寫。
* **活體類型**：活體檢測類型，常見取值 `ACTION`（動作活體）、`SILENT`（靜默）、`LIP`（脣語）。僅在人臉核身體驗下生效。
* **分數閾值**：人臉相似度判斷閾值，測試階段可從 70 起調，再根據誤判情況微調。

### 測試前確認

* 先在騰訊雲控制台開通人臉核身（FaceID）或人臉識別（IAI）相關服務。
* 確認 SecretId 和 SecretKey 對應的騰訊雲賬號已開通所需服務。
* 實名覈驗走 FaceID 鏈路，照片人臉檢測走 IAI 鏈路，兩者不要混用。

***

## 停用

進入插件詳情頁，點擊頭部 **「停用」**，在確認彈窗中確認即可。

***

## 常見問題

<AccordionGroup>
  <Accordion title="人臉核身（FaceID）和人臉識別（IAI）有什麼區別？">
    FaceID 用於實名驗證、活體核身等"確認本人"的場景；IAI 用於照片人臉檢測、比對和搜索。兩者走不同的 API 鏈路，請按實際場景選擇。
  </Accordion>

  <Accordion title="鑑權失敗怎麼辦？">
    請檢查 SecretId 和 SecretKey 是否填寫正確，確認騰訊雲控制台已開通 FaceID 或 IAI 服務，且密鑰所屬賬號確實已開通對應能力。
  </Accordion>
</AccordionGroup>