Domain name for API request: faceid.intl.tencentcloudapi.com.
This API is used to judge whether the image passed in and the ID photo in the authoritative database belong to the same person based on the identity information (this interface has stopped integration, new customers please use the photo face verification (V2.0) API).
A maximum of 100 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: ImageRecognition. |
| Version | Yes | String | Common Params. The value used for this API: 2018-03-01. |
| Region | No | String | Common Params. This parameter is not required for this API. |
| IdCard | Yes | String | Identity card number |
| Name | Yes | String | Name. For Chinese, please use UTF-8 encode. |
| ImageBase64 | Yes | String | Image for face comparison, the Base64 value of the image. |
| Optional | No | String | This parameter is not required for this API. |
| Encryption | No | Encryption | Sensitive data encryption information. Users with encryption requirements for incoming information (name, identity card number) can use this parameter. For details, please click the left-side link. |
| Parameter Name | Type | Description |
|---|---|---|
| Sim | Float | Similarity, value ranges from 0.00 to 100.00. Recommend judging as the same person when similarity is at least 70. Threshold can be self-adjusted based on specific scenarios (pass rate for false matches is one in a thousand at threshold 70, and one in ten thousand at threshold 80). |
| Result | String | Business error code. Successfully returns Success in successful case. For error conditions, refer to the FailedOperation part in the error code list below. |
| Description | String | Business result description. |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
https://faceid.intl.tencentcloudapi.com/?Action=ImageRecognition
&IdCard=11204416541220243X
&Name=Wei Xiaobao
&ImageBase64=<ImageBase64>
&<Common request parameters>
{
"Response": {
"Result": "Success",
"Description": "Success"
"Sim": 89.88,
"RequestId": "f904f4cf-75db-4f8f-a5ec-dc4f942c7f7a"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| FailedOperation.CompareFail | Comparison failed. |
| FailedOperation.CompareLibServiceUnavailable | Comparison library source maintaining, temporarily unavailable |
| FailedOperation.CompareLowSimilarity | The comparison similarity did not reach the passing standard. |
| FailedOperation.CompareSystemError | Error calling the comparison engine API. |
| FailedOperation.DecryptSystemError | Decryption failed. |
| FailedOperation.IdFormatError | Input identity card number error. |
| FailedOperation.IdNameMisMatch | Name and ID card number mismatch. Please verify and try again after. |
| FailedOperation.IdNoExistSystem | The number is not found in the database. Please go to the place of household registration to verify. |
| FailedOperation.IdPhotoNoExist | The photo of this number is not found in the database. Please go to the place of household registration to verify. |
| FailedOperation.IdPhotoPoorQuality | Document image is of poor quality. Please update and try again. |
| FailedOperation.IdPhotoSystemNoanswer | The customer database, self-built database, or authentication center failed to return the photo. Try again later. |
| FailedOperation.IdentityAuthLimitExceeded | Name/ID card number authentication attempts exceed the daily limit. Please retry the next day. |
| FailedOperation.LifePhotoDetectFaces | Multiple faces are detected. |
| FailedOperation.LifePhotoDetectFake | Real person comparison failed. |
| FailedOperation.LifePhotoDetectNoFaces | Failed to detect a full face. |
| FailedOperation.LifePhotoPoorQuality | The resolution of the image passed in is too low. Please upload a new one. |
| FailedOperation.LifePhotoSizeError | The image passed in is too large or too small. |
| FailedOperation.NameFormatError | Input name error. |
| FailedOperation.StsUnAuthErrError | STS unauthorized. |
| FailedOperation.UnKnown | Unknown internal error. |
| InvalidParameter | Invalid parameter. |
| InvalidParameter.UnsupportEncryptField | Unencrypted fields exist. Refer to the documentation to modify. |
| InvalidParameterValue | Incorrect parameter value. |
| UnauthorizedOperation | Unauthorized operation. |
| UnauthorizedOperation.Arrears | The account is in arrears. |
| UnauthorizedOperation.NonAuthorize | Identity verification has not been completed for the account. |
| UnauthorizedOperation.Nonactivated | The service has not been activated. |
| UnsupportedOperation | Unsupported operation. |
文档反馈