# Tencent Cloud FaceID API

> Tencent Cloud FaceID API on Apizie: 37 endpoints (Bank Card2 EVerification, Bank Card4 EVerification, Bank Card Verification, Check Bank Card Information, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:tencent-faceid/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-faceid`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://apizie.tech/api/cloud/tencent-faceid
- OpenAPI: https://apizie.tech/api/cloud/tencent-faceid/openapi.json

Tencent Cloud API 3.0 for FaceID (faceid). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Bank Card2 EVerification
`POST https://apizie.tech/v1/cloud:tencent-faceid/bank-card2-everification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Name | string | yes |  |
| BankCard | string | yes |  |
| Encryption | object | no |  |

### Bank Card4 EVerification
`POST https://apizie.tech/v1/cloud:tencent-faceid/bank-card4-everification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Name | string | yes |  |
| BankCard | string | yes |  |
| Phone | string | yes |  |
| IdCard | string | yes |  |
| CertType | integer | no |  |
| Encryption | object | no |  |

### Bank Card Verification
`POST https://apizie.tech/v1/cloud:tencent-faceid/bank-card-verification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| IdCard | string | yes |  |
| Name | string | yes |  |
| BankCard | string | yes |  |
| CertType | integer | no |  |
| Encryption | object | no |  |

### Check Bank Card Information
`POST https://apizie.tech/v1/cloud:tencent-faceid/check-bank-card-information` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BankCard | string | yes |  |
| Encryption | object | no |  |

### Check Eid Token Status
`POST https://apizie.tech/v1/cloud:tencent-faceid/check-eid-token-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EidToken | string | yes |  |

### Check Id Card Information
`POST https://apizie.tech/v1/cloud:tencent-faceid/check-id-card-information` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ImageBase64 | string | no |  |
| ImageUrl | string | no |  |
| Config | string | no |  |
| IsEncrypt | boolean | no |  |
| IsEncryptResponse | boolean | no |  |
| Encryption | object | no |  |

### Check Id Name Date
`POST https://apizie.tech/v1/cloud:tencent-faceid/check-id-name-date` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Name | string | yes |  |
| IdCard | string | yes |  |
| ValidityBegin | string | yes |  |
| ValidityEnd | string | yes |  |
| Encryption | object | no |  |

### Check Phone And Name
`POST https://apizie.tech/v1/cloud:tencent-faceid/check-phone-and-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Mobile | string | yes |  |
| Name | string | yes |  |
| Encryption | object | no |  |

### Detect AIFake Faces
`POST https://apizie.tech/v1/cloud:tencent-faceid/detect-aifake-faces` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FaceInput | string | no |  |
| FaceInputType | integer | no |  |
| Encryption | object | no |  |
| EncryptedBody | string | no |  |

### Detect Auth
`POST https://apizie.tech/v1/cloud:tencent-faceid/detect-auth` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| RuleId | string | yes |  |
| TerminalType | string | no |  |
| IdCard | string | no |  |
| Name | string | no |  |
| RedirectUrl | string | no |  |
| Extra | string | no |  |
| ImageBase64 | string | no |  |
| Encryption | object | no |  |
| IntentionVerifyText | string | no |  |
| IntentionQuestions | array | no |  |
| IntentionActions | array | no |  |
| Config | object | no |  |

### Encrypted Phone Verification
`POST https://apizie.tech/v1/cloud:tencent-faceid/encrypted-phone-verification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| IdCard | string | yes |  |
| Name | string | yes |  |
| Phone | string | yes |  |
| EncryptionMode | string | yes |  |

### Get Action Sequence
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-action-sequence` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ActionType | string | no |  |

### Get Detect Info
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-detect-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BizToken | string | yes |  |
| RuleId | string | yes |  |
| InfoType | string | no |  |

### Get Detect Info Enhanced
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-detect-info-enhanced` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BizToken | string | yes |  |
| RuleId | string | yes |  |
| InfoType | string | no |  |
| BestFramesCount | integer | no |  |
| IsCutIdCardImage | boolean | no |  |
| IsNeedIdCardAvatar | boolean | no |  |
| IsEncrypt | boolean | no |  |
| Encryption | object | no |  |
| IsEncryptResponse | boolean | no |  |
| IsReturnAllVideo | boolean | no |  |

### Get Eid Result
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-eid-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EidToken | string | yes |  |
| InfoType | string | no |  |
| BestFramesCount | integer | no |  |
| IsCutIdCardImage | boolean | no |  |
| IsNeedIdCardAvatar | boolean | no |  |

### Get Eid Token
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-eid-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| MerchantId | string | yes |  |
| IdCard | string | no |  |
| Name | string | no |  |
| Extra | string | no |  |
| Config | object | no |  |
| RedirectUrl | string | no |  |
| Encryption | object | no |  |

### Get Face Id Result
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-face-id-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FaceIdToken | string | yes |  |
| IsNeedVideo | boolean | no |  |
| IsNeedBestFrame | boolean | no |  |
| IsEncryptResponse | boolean | no |  |
| Encryption | object | no |  |

### Get Face Id Risk Info
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-face-id-risk-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| FaceIdToken | string | yes |  |

### Get Face Id Token
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-face-id-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| CompareLib | string | yes |  |
| IdCard | string | no |  |
| Name | string | no |  |
| ImageBase64 | string | no |  |
| Meta | string | no |  |
| Extra | string | no |  |
| UseCos | boolean | no |  |
| Encryption | object | no |  |
| RuleId | string | no |  |
| MetaData | string | no |  |

### Get Faceid Risk Info Token
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-faceid-risk-info-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Meta | string | no |  |
| Extra | string | no |  |

### Get Live Code
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-live-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

### Get NFCToken
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-nfctoken` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |

### Get We Chat Bill Details
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-we-chat-bill-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Date | string | yes |  |
| Cursor | integer | yes |  |
| RuleId | string | no |  |

### Get Wx NFCResult
`POST https://apizie.tech/v1/cloud:tencent-faceid/get-wx-nfcresult` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| NFCToken | string | yes |  |

### Id Card OCRVerification
`POST https://apizie.tech/v1/cloud:tencent-faceid/id-card-ocrverification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| IdCard | string | no |  |
| Name | string | no |  |
| ImageBase64 | string | no |  |
| ImageUrl | string | no |  |
| Encryption | object | no |  |
| Config | string | no |  |

### Id Card Verification
`POST https://apizie.tech/v1/cloud:tencent-faceid/id-card-verification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| IdCard | string | yes |  |
| Name | string | yes |  |
| Encryption | object | no |  |

### Image Recognition V2
`POST https://apizie.tech/v1/cloud:tencent-faceid/image-recognition-v2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| IdCard | string | yes |  |
| Name | string | yes |  |
| ImageBase64 | string | yes |  |
| Optional | string | no |  |
| Encryption | object | no |  |
| Extra | string | no |  |

### Liveness Compare
`POST https://apizie.tech/v1/cloud:tencent-faceid/liveness-compare` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| LivenessType | string | yes |  |
| ImageBase64 | string | no |  |
| ImageUrl | string | no |  |
| ValidateData | string | no |  |
| Optional | string | no |  |
| VideoBase64 | string | no |  |
| VideoUrl | string | no |  |

### Liveness Recognition
`POST https://apizie.tech/v1/cloud:tencent-faceid/liveness-recognition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| IdCard | string | yes |  |
| Name | string | yes |  |
| LivenessType | string | yes |  |
| VideoBase64 | string | no |  |
| VideoUrl | string | no |  |
| ValidateData | string | no |  |
| Optional | string | no |  |
| Encryption | object | no |  |

### Minors Verification
`POST https://apizie.tech/v1/cloud:tencent-faceid/minors-verification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Type | string | yes |  |
| Mobile | string | no |  |
| IdCard | string | no |  |
| Name | string | no |  |
| Encryption | object | no |  |

### Mobile Network Time Verification
`POST https://apizie.tech/v1/cloud:tencent-faceid/mobile-network-time-verification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Mobile | string | yes |  |
| Encryption | object | no |  |

### Mobile Status
`POST https://apizie.tech/v1/cloud:tencent-faceid/mobile-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Mobile | string | yes |  |
| Encryption | object | no |  |

### Parse Nfc Data
`POST https://apizie.tech/v1/cloud:tencent-faceid/parse-nfc-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ReqId | string | yes |  |

### Phone Verification
`POST https://apizie.tech/v1/cloud:tencent-faceid/phone-verification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| IdCard | string | yes |  |
| Name | string | yes |  |
| Phone | string | yes |  |
| VerifyMode | string | no |  |
| CiphertextBlob | string | no |  |
| EncryptList | array | no |  |
| Iv | string | no |  |

### Phone Verification CMCC
`POST https://apizie.tech/v1/cloud:tencent-faceid/phone-verification-cmcc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| IdCard | string | yes |  |
| Name | string | yes |  |
| Phone | string | yes |  |
| Encryption | object | no |  |

### Phone Verification CTCC
`POST https://apizie.tech/v1/cloud:tencent-faceid/phone-verification-ctcc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| IdCard | string | yes |  |
| Name | string | yes |  |
| Phone | string | yes |  |
| Encryption | object | no |  |

### Phone Verification CUCC
`POST https://apizie.tech/v1/cloud:tencent-faceid/phone-verification-cucc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| IdCard | string | yes |  |
| Name | string | yes |  |
| Phone | string | yes |  |
| Encryption | object | no |  |

## Example
```
curl "https://apizie.tech/v1/cloud:tencent-faceid/bank-card2-everification" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud FaceID API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-faceid/bank-card2-everification with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud FaceID API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud FaceID itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud FaceID API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-faceid.

### What is the status of the Tencent Cloud FaceID API?
Needs your own provider key (bring your own key)