# Tencent Cloud Face Recognition API

> Tencent Cloud Face Recognition API on Apizie: 31 endpoints (Analyze Dense Landmarks, Analyze Face, Compare Face, Compare Mask Face, …) 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-iai/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

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

## Endpoints

### Analyze Dense Landmarks
`POST https://apizie.tech/v1/cloud:tencent-iai/analyze-dense-landmarks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Mode | integer | no |  |
| Image | string | no |  |
| Url | string | no |  |
| FaceModelVersion | string | no |  |
| NeedRotateDetection | integer | no |  |

### Analyze Face
`POST https://apizie.tech/v1/cloud:tencent-iai/analyze-face` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Mode | integer | no |  |
| Image | string | no |  |
| Url | string | no |  |
| FaceModelVersion | string | no |  |
| NeedRotateDetection | integer | no |  |

### Compare Face
`POST https://apizie.tech/v1/cloud:tencent-iai/compare-face` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ImageA | string | no |  |
| ImageB | string | no |  |
| UrlA | string | no |  |
| UrlB | string | no |  |
| FaceModelVersion | string | no |  |
| QualityControl | integer | no |  |
| NeedRotateDetection | integer | no |  |
| FaceMatchingStrategy | integer | no |  |

### Compare Mask Face
`POST https://apizie.tech/v1/cloud:tencent-iai/compare-mask-face` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ImageA | string | no |  |
| ImageB | string | no |  |
| UrlA | string | no |  |
| UrlB | string | no |  |
| FaceModelVersion | string | no |  |
| QualityControl | integer | no |  |

### Copy Person
`POST https://apizie.tech/v1/cloud:tencent-iai/copy-person` (byok)

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

### Create Face
`POST https://apizie.tech/v1/cloud:tencent-iai/create-face` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PersonId | string | yes |  |
| Images | array | no |  |
| Urls | array | no |  |
| FaceMatchThreshold | number | no |  |
| QualityControl | integer | no |  |
| NeedRotateDetection | integer | no |  |

### Create Group
`POST https://apizie.tech/v1/cloud:tencent-iai/create-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| GroupName | string | yes |  |
| GroupId | string | yes |  |
| GroupExDescriptions | array | no |  |
| Tag | string | no |  |
| FaceModelVersion | string | no |  |

### Create Person
`POST https://apizie.tech/v1/cloud:tencent-iai/create-person` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| GroupId | string | yes |  |
| PersonName | string | yes |  |
| PersonId | string | yes |  |
| Gender | integer | no |  |
| PersonExDescriptionInfos | array | no |  |
| Image | string | no |  |
| Url | string | no |  |
| UniquePersonControl | integer | no |  |
| QualityControl | integer | no |  |
| NeedRotateDetection | integer | no |  |

### Delete Face
`POST https://apizie.tech/v1/cloud:tencent-iai/delete-face` (byok)

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

### Delete Group
`POST https://apizie.tech/v1/cloud:tencent-iai/delete-group` (byok)

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

### Delete Person
`POST https://apizie.tech/v1/cloud:tencent-iai/delete-person` (byok)

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

### Delete Person From Group
`POST https://apizie.tech/v1/cloud:tencent-iai/delete-person-from-group` (byok)

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

### Detect Face
`POST https://apizie.tech/v1/cloud:tencent-iai/detect-face` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| MaxFaceNum | integer | no |  |
| MinFaceSize | integer | no |  |
| Image | string | no |  |
| Url | string | no |  |
| NeedFaceAttributes | integer | no |  |
| NeedQualityDetection | integer | no |  |
| FaceModelVersion | string | no |  |
| NeedRotateDetection | integer | no |  |

### Detect Face Attributes
`POST https://apizie.tech/v1/cloud:tencent-iai/detect-face-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| MaxFaceNum | integer | no |  |
| Image | string | no |  |
| Url | string | no |  |
| FaceAttributesType | string | no |  |
| NeedRotateDetection | integer | no |  |
| FaceModelVersion | string | no |  |

### Detect Face Similarity
`POST https://apizie.tech/v1/cloud:tencent-iai/detect-face-similarity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ImageA | string | no |  |
| ImageB | string | no |  |
| UrlA | string | no |  |
| UrlB | string | no |  |
| QualityControl | integer | no |  |

### Detect Live Face Accurate
`POST https://apizie.tech/v1/cloud:tencent-iai/detect-live-face-accurate` (byok)

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

### Get Group Info
`POST https://apizie.tech/v1/cloud:tencent-iai/get-group-info` (byok)

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

### Get Group List
`POST https://apizie.tech/v1/cloud:tencent-iai/get-group-list` (byok)

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

### Get Person Base Info
`POST https://apizie.tech/v1/cloud:tencent-iai/get-person-base-info` (byok)

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

### Get Person Group Info
`POST https://apizie.tech/v1/cloud:tencent-iai/get-person-group-info` (byok)

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

### Get Person List
`POST https://apizie.tech/v1/cloud:tencent-iai/get-person-list` (byok)

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

### Get Person List Num
`POST https://apizie.tech/v1/cloud:tencent-iai/get-person-list-num` (byok)

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

### Modify Group
`POST https://apizie.tech/v1/cloud:tencent-iai/modify-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| GroupId | string | yes |  |
| GroupName | string | no |  |
| GroupExDescriptionInfos | array | no |  |
| Tag | string | no |  |

### Modify Person Base Info
`POST https://apizie.tech/v1/cloud:tencent-iai/modify-person-base-info` (byok)

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

### Modify Person Group Info
`POST https://apizie.tech/v1/cloud:tencent-iai/modify-person-group-info` (byok)

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

### Search Faces
`POST https://apizie.tech/v1/cloud:tencent-iai/search-faces` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| GroupIds | array | yes |  |
| Image | string | no |  |
| Url | string | no |  |
| MaxFaceNum | integer | no |  |
| MinFaceSize | integer | no |  |
| MaxPersonNum | integer | no |  |
| NeedPersonInfo | integer | no |  |
| QualityControl | integer | no |  |
| FaceMatchThreshold | number | no |  |
| NeedRotateDetection | integer | no |  |

### Search Faces Returns By Group
`POST https://apizie.tech/v1/cloud:tencent-iai/search-faces-returns-by-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| GroupIds | array | yes |  |
| Image | string | no |  |
| Url | string | no |  |
| MaxFaceNum | integer | no |  |
| MinFaceSize | integer | no |  |
| MaxPersonNumPerGroup | integer | no |  |
| NeedPersonInfo | integer | no |  |
| QualityControl | integer | no |  |
| FaceMatchThreshold | number | no |  |
| NeedRotateDetection | integer | no |  |

### Search Persons
`POST https://apizie.tech/v1/cloud:tencent-iai/search-persons` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| GroupIds | array | yes |  |
| Image | string | no |  |
| Url | string | no |  |
| MaxFaceNum | integer | no |  |
| MinFaceSize | integer | no |  |
| MaxPersonNum | integer | no |  |
| QualityControl | integer | no |  |
| FaceMatchThreshold | number | no |  |
| NeedPersonInfo | integer | no |  |
| NeedRotateDetection | integer | no |  |

### Search Persons Returns By Group
`POST https://apizie.tech/v1/cloud:tencent-iai/search-persons-returns-by-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| GroupIds | array | yes |  |
| Image | string | no |  |
| Url | string | no |  |
| MaxFaceNum | integer | no |  |
| MinFaceSize | integer | no |  |
| MaxPersonNumPerGroup | integer | no |  |
| QualityControl | integer | no |  |
| FaceMatchThreshold | number | no |  |
| NeedPersonInfo | integer | no |  |
| NeedRotateDetection | integer | no |  |

### Verify Face
`POST https://apizie.tech/v1/cloud:tencent-iai/verify-face` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PersonId | string | yes |  |
| Image | string | no |  |
| Url | string | no |  |
| QualityControl | integer | no |  |
| NeedRotateDetection | integer | no |  |

### Verify Person
`POST https://apizie.tech/v1/cloud:tencent-iai/verify-person` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PersonId | string | yes |  |
| Image | string | no |  |
| Url | string | no |  |
| QualityControl | integer | no |  |
| NeedRotateDetection | integer | no |  |

## Example
```
curl "https://apizie.tech/v1/cloud:tencent-iai/analyze-dense-landmarks" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Face Recognition API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-iai/analyze-dense-landmarks with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Tencent Cloud Face Recognition 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-iai.

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