> ## 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>