tencent cloud

人脸核身

错误码

下载
聚焦模式
字号
最后更新时间: 2026-10-23 15:20:39
本文档已由 AI 辅助审校
本文描述腾讯云 eKYC 产品的所有服务错误码与对应计费关系(是否计费列中“N”代表“否”,“Y”代表“是”):

公共错误码(所有服务共用)

错误码
描述
是否计费
InvalidParameter
Invalid parameter.
N
InvalidParameterValue.BizTokenIllegal
BizToken illegal.
N
InvalidParameterValue.BizTokenExpired
BizToken expired.
N
UnauthorizedOperation.Nonactivated
The service has not been activated.
N
UnauthorizedOperation.Activating
The service is activating.
N
UnauthorizedOperation.ActivateError
The service has not been activated.
N
UnauthorizedOperation.Arrears
The account has overdue payments
N
OperationDenied
Operation denied
N
UnauthorizedOperation.NonAuthorize
Identity verification has not been completed for the account.
N
UnauthorizedOperation
Unauthorized operation.
N
FailedOperation.ImageSizeTooLarge
Image size too large
N
InternalError
Internal error
N
以下是 eKYC 子产品的错误码列表信息:

卡证活体人脸比对(移动端 H5)错误码

错误码
描述
是否计费
0
Success, tap Next to continue
Y
1
Invalid parameter
N
2
Incorrect parameter value
N
3
Bad request
N
4
Internal service error
N
8
Internal service error
N
9
Internal service error
N
10
Internal service error
N
11
Internal service error
N
14
Verification has been completed
N
15
Token expired
N
16
Retry limit has been reached
N
202
Failed to get video
N
1001
Failed to call the liveness engine
N
1002
Suspected spoofed recording
N
1003
Real person detection failed
N
1004
Face detection failed
N
1005
Liveness detection failed
N
1101
No sound is detected
N
1102
The face is not fully exposed
N
1103
Speech recognition failed
N
1104
The video format is incorrect
N
1105
Failed to pull the video. Please try again
N
1106
The volume of the video is too low
N
1107
The video is empty or its size is inappropriate. The recording duration should be about 6 seconds
N
1108
The video definition is too low
N
1109
The lip movement range is too small
N
1201
The lighting is too dim
N
1202
The lighting is too strong
N
1203
The face is too close to the screen
N
1204
The face is too far right from the screen
N
1205
The face is too far from the screen
N
1206
The face is too far left from the screen
N
1207
No motions of eye closing are detected
N
1208
The first motion is not detected
N
1209
No motions of mouth opening are detected
N
1210
Failed to detect a full face
N
1211
Mouth opening detected during liveness detection
N
1301
Real person detection failed
N
1302
Real person detection did not reach the passing standard
N
1303
Video duration is too short. Please record a video longer than 2 seconds
N
1401
Liveness detection failed
N
1402
Liveness detection failed, you have not enabled downgrade mode
N
1403
API incompatibility
N
1404
Failed to obtain camera permission. Please clear browser cache and authorize again
N
1406
Network exception. Please try again
N
1407
Video recording interrupted abnormally, please try again
N
1408
Camera permission acquisition timed out, please try again
N
1409
Verification process timed out
N
1410
User exited voluntarily
N
2001
Error calling the comparison engine
N
2004
The image passed in is too large or too small
N
2010
Multiple faces are detected
N
2011
Real person comparison failed
N
2012
Multiple faces detected
N
2013
No faces are detected
N
2014
The resolution of the image passed in is too low. Please upload a new one
N
2015
Comparison failed
N
2016
The comparison similarity did not reach the passing standard
Y
4001
Missing token
N
4002
Token not found
N
4003
Incorrect token
N
4004
Token has expired
N
4005
Token already used
N
4006
Operation is too frequent
N
3001
Verification Failed.
N
3002
OCR retry over limit
N
3003
Liveness retry over limit
Y
3004
Fail to get user authorization
N
3005
API is not compatible
N
3006
Retry limit error,fail to enable the downgrade mode
N
5001
Server internal error
N
5002
Incorrect parameter value
N
6001
OCR service error
N
6002
Retry limit error
N
6003
Card file is too large
N
6004
OCR processing failed
N
6005
Asynchronous OCR processing
N
6006
OCR counterfeit warning detected
Y
6007
OCR maximum polling limit exceeded
N
6010
Document type mismatch
N
6011
Image parsing failed, please upload again
N
6012
Image size is too small
N
6013
Image size is too large
N
7001
Authentication failed
N
7002
You've been blocked,please contact Tencent Cloud
N

活体人脸比对(移动端 H5)拍摄提示语

Prompt
Please blink
Please open your mouth
Nod please
Please shake your head
Please keep your face within the detection frame
No face detected
Please make sure there is only one face in the detection frame
Please move your face into the detection frame
Please come closer
Please stay away
Please move to left
Please move to right
Please move up
Please move down
Please do not cover the left face
Please do not cover your right face
Current light: too dark
Current light: too bright
Please do not cover the left eye
Please do not cover the right eye
Please do not cover your nose
Please do not cover your mouth
Face detection timed out, and recognition failed
Invalid request
Connection lost
Connection lost
Read websocket message error
Invalid token
Invalid action sequence
Token expired
Missing best frame
Engine init fail
Invoke engine failed
Engine network failed
Invalid engine response
Unknown error
Verifying, please hold your posture.
Please wait a moment for the result…
Please don't open your mouth


活体人脸比对(App SDK)错误码

错误码
描述
是否计费
0
Succeeded
Y
1001
Failed to call the liveness engine
N
1002
Suspected spoofed recording
Y
1004
Face detection failed
N
1005
Liveness detection failed
Y
1201
Lighting is too dark or overexposed
Y
2004
The image passed in is too large or too small
N
2012
Multiple faces detected
N
2013
No face was detected, or the face detected was incomplete
N
2014
The image resolution is too low or the quality does not meet the requirements
N
2015
Face comparison failed
N
2016
The similarity did not reach the standard passing threshold
Y
2017
Facial occlusion detected
Y
8001
High security risk detected
Y
8002
Blocked by security blacklist
Y
-999
The verification process wasn't finished
N

活体人脸比对(纯 API)错误码

错误码
描述
是否计费
Success
Success
Y
FailedOperation.CompareLowSimilarity
The comparison similarity did not reach the passing standard.
Y
FailedOperation.ActionCloseEye
No motions of eye closing are detected.
N
FailedOperation.ActionFaceClose
The face is too close to the screen.
N
FailedOperation.ActionFaceFar
The face is too far from the screen.
N
FailedOperation.ActionFaceLeft
The face is too far left from the screen.
N
FailedOperation.ActionFaceRight
The face is too far right from the screen.
N
FailedOperation.ActionFirstAction
No movement is detected.
N
FailedOperation.ActionLightDark
The lighting is too dim.
N
FailedOperation.ActionLightStrong
The lighting is too strong.
N
FailedOperation.ActionNodetectFace
Failed to detect a full face.
N
FailedOperation.ActionOpenMouth
No motions of mouth opening are detected.
N
FailedOperation.CompareFail
Comparison failed.
N
FailedOperation.CompareSystemError
Error calling the comparison engine API.
N
FailedOperation.DownLoadError
File download failed.
N
FailedOperation.DownLoadTimeoutError
File download timed out.
N
FailedOperation.LifePhotoDetectFaces
Multiple faces are detected.
N
FailedOperation.LifePhotoDetectFake
Real person comparison failed.
N
FailedOperation.LifePhotoDetectNoFaces
Failed to detect a full face.
N
FailedOperation.LifePhotoPoorQuality
The resolution of the image passed in is too low. Please upload a new one.
N
FailedOperation.LifePhotoSizeError
The image passed in is too large or too small.
N
FailedOperation.LipFaceIncomplete
The face is not fully exposed.
N
FailedOperation.LipMoveSmall
The lip movement range is too small.
N
FailedOperation.LipNetFailed
Failed to pull the video. Please try again.
N
FailedOperation.LipSizeError
The video is empty or its size is inappropriate. The recording duration should be about 6 seconds.
N
FailedOperation.LipVideoInvalid
The video format is incorrect.
N
FailedOperation.LipVideoQuaility
The video definition is too low.
N
FailedOperation.LipVoiceDetect
No sound is detected.
N
FailedOperation.LipVoiceLow
The volume of the video is too low.
N
FailedOperation.LipVoiceRecognize
Speech recognition failed.
N
FailedOperation.LivessBestFrameError
Face detection failed. Unable to extract the photo for comparison.
N
FailedOperation.LivessDetectFail
Liveness detection failed.
N
FailedOperation.LivessDetectFake
Suspected spoofed recording.
N
FailedOperation.LivenessSystemError
Error calling the liveness engine API.
N
FailedOperation.LivenessUnknownError
Video-based real person detection failed.
N
FailedOperation.SilentDetectFail
Real person detection failed.
N
FailedOperation.SilentEyeLiveFail
Eye detection failed.
N
FailedOperation.SilentFaceDetectFail
No face is detected in the video.
N
FailedOperation.SilentFaceQualityFail
Low face quality.
N
FailedOperation.SilentFaceWithMaskFail
A face mask is detected.
N
FailedOperation.SilentMouthLiveFail
Mouth detection failed.
N
FailedOperation.SilentMultiFaceFail
Multiple faces are detected in the video.
N
FailedOperation.SilentPictureLiveFail
The video might be spoofed.
N
FailedOperation.SilentThreshold
Real person detection did not reach the passing standard.
N
FailedOperation.SilentTooShort
The video is too short. Please capture a video longer than 2 seconds.
N
FailedOperation.Unknown
Unknown internal error.
N
InvalidParameter
Invalid parameter.
N
InvalidParameterValue
Incorrect parameter value.
N
UnauthorizedOperation
Unauthorized operation.
N
UnauthorizedOperation.Arrears
The account is in arrears.
N
UnauthorizedOperation.NonAuthorize
Identity verification has not been completed for the account.
N
UnauthorizedOperation.Nonactivated
The service has not been activated.
N
UnsupportedOperation
Unsupported operation.
N

卡证活体人脸比对(App SDK)错误码

错误码
描述
是否计费
0
Success
Y
1001
Failed to call the liveness engine
Y
1002
Suspected spoofed recording
Y
1004
Face detection failed
Y
1005
Liveness detection failed
Y
1201
Lighting is too dark or overexposed
Y
2004
The image passed in is too large or too small
Y
2012
Multiple faces detected
Y
2013
No faces are detected
Y
2014
The resolution of the image passed in is too low. Please upload a new one
Y
2015
Comparison failed
Y
2016
The comparison similarity did not reach the passing standard
Y
2017
Facial occlusion detected
Y
8001
High security risk detected
Y
8002
Blocked by security blacklist
Y

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈