Skip to main content

​
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

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