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

# Tencent Cloud FaceID

> Add face recognition, liveness detection, and identity verification to your app using Tencent Cloud FaceID.

## What It Is

Tencent Cloud FaceID is a face recognition plugin powered by Tencent Cloud services. It supports two scenarios:

* **FaceID**: real-name verification, liveness checks, and KYC (know your customer) flows.
* **IAI** (Image AI): photo face detection, comparison, and search.

The plugin is enabled per project. After enabling, configure your Tencent Cloud keys and parameters on the plugin detail page.

***

## Where to Find It

1. Open any project.
2. Switch to the **Build** tab.
3. Open **Skill Library** from the left navigation.
4. Find **Tencent Cloud FaceID** in the plugin cards.

***

## Enable

Any of the following enables it:

* Hover the plugin card and click **Use**.
* Open the plugin detail page and click **Use** in the header.
* Confirm the plugin enablement card when the AI assistant suggests it in chat.

After enabling, configure your credentials on the plugin detail page.

***

## Configure

Open the plugin detail page after enabling.

### Required

* **SecretId**: your Tencent Cloud API key ID, obtained from CAM Access Key Management.
* **SecretKey**: your Tencent Cloud API key secret. Keep it secure and never expose it in public environments or frontend source code.

These two fields must either both be filled in or both left blank.

### Optional

* **Default mode**: the default FaceID mode, for example `liveness_recognition` for liveness checks. Set this based on your target use case.
* **Liveness type**: the liveness detection type. Common values are `ACTION` (action-based), `SILENT` (silent), and `LIP` (lip movement). Applies only to FaceID liveness scenarios.
* **Score threshold**: the face similarity threshold for liveness checks or photo comparison. Start from 70 during testing and fine-tune it based on false matches.

### Before you test

* Enable the relevant Tencent Cloud FaceID or IAI services in the Tencent Cloud console first.
* Make sure the SecretId and SecretKey belong to the Tencent Cloud account that actually has the service enabled.
* Use FaceID for real-name verification / liveness checks. Use IAI for photo face detection / comparison.

***

## Disable

Open the plugin detail page, click **Disable** in the header, and confirm in the dialog.

***

## FAQ

<AccordionGroup>
  <Accordion title="What is the difference between FaceID and IAI?">
    FaceID is designed for real-name verification, liveness checks, and KYC scenarios that confirm whether the user is the same person. IAI is for photo face detection, comparison, and search. They use different API paths.
  </Accordion>

  <Accordion title="Why is authentication failing?">
    Check whether SecretId and SecretKey are correct, verify that FaceID or IAI has been enabled in your Tencent Cloud console, and make sure the credentials are for the account that has the service activated.
  </Accordion>
</AccordionGroup>