错误码

最近更新时间:2025-02-19 02:16:51

我的收藏

功能说明

如果返回结果中存在 Error 字段,则表示调用 API 接口失败。例如:

 {
    "Response": {
        "Error": {
            "Code": "AuthFailure.SignatureFailure",
            "Message": "The provided credentials could not be validated. Please check your signature is correct."
        },
        "RequestId": "ed93f3cb-f35e-473f-b9f3-0d451b8b79c6"
    }
}

Error 中的 Code 表示错误码,Message 表示该错误的具体信息。

错误码列表

公共错误码

错误码 说明
ActionOffline 接口已下线。
AuthFailure.InvalidAuthorization 请求头部的 Authorization 不符合腾讯云标准。
AuthFailure.InvalidSecretId 密钥非法(不是云 API 密钥类型)。
AuthFailure.MFAFailure MFA 错误。
AuthFailure.SecretIdNotFound 密钥不存在。请在 控制台 检查密钥是否已被删除或者禁用,如状态正常,请检查密钥是否填写正确,注意前后不得有空格。
AuthFailure.SignatureExpire 签名过期。Timestamp 和服务器时间相差不得超过五分钟,请检查本地时间是否和标准时间同步。
AuthFailure.SignatureFailure 签名错误。签名计算错误,请对照调用方式中的签名方法文档检查签名计算过程。
AuthFailure.TokenFailure token 错误。
AuthFailure.UnauthorizedOperation 请求未授权。请参考 CAM 文档对鉴权的说明。
DryRunOperation DryRun 操作,代表请求将会是成功的,只是多传了 DryRun 参数。
FailedOperation 操作失败。
InternalError 内部错误。
InvalidAction 接口不存在。
InvalidParameter 参数错误(包括参数格式、类型等错误)。
InvalidParameterValue 参数取值错误。
InvalidRequest 请求 body 的 multipart 格式错误。
IpInBlacklist IP 地址在黑名单中。
IpNotInWhitelist IP 地址不在白名单中。
LimitExceeded 超过配额限制。
MissingParameter 缺少参数。
NoSuchProduct 产品不存在
NoSuchVersion 接口版本不存在。
RequestLimitExceeded 请求的次数超过了频率限制。
RequestLimitExceeded.GlobalRegionUinLimitExceeded 主账号超过频率限制。
RequestLimitExceeded.IPLimitExceeded IP 限频。
RequestLimitExceeded.UinLimitExceeded 主账号限频。
RequestSizeLimitExceeded 请求包超过限制大小。
ResourceInUse 资源被占用。
ResourceInsufficient 资源不足。
ResourceNotFound 资源不存在。
ResourceUnavailable 资源不可用。
ResponseSizeLimitExceeded 返回包超过限制大小。
ServiceUnavailable 当前服务暂时不可用。
UnauthorizedOperation 未授权操作。
UnknownParameter 未知参数错误,用户多传未定义的参数会导致错误。
UnsupportedOperation 操作不支持。
UnsupportedProtocol http(s) 请求协议错误,只支持 GET 和 POST 请求。
UnsupportedRegion 接口不支持所传地域。

业务错误码

错误码 说明
AuthFailure CAM签名/鉴权错误。
FailedOperation.AudioDecodeFailed 音频解码失败。
FailedOperation.BodyJointsFail 人体关键点检测失败。
FailedOperation.DownloadError 下载视频出错。
FailedOperation.DriverFailed 驱动失败
FailedOperation.FaceSizeTooSmall 人脸框太小,无法识别使用。
FailedOperation.ImageBodyJoinsUndetected 图片身体部位有遮挡或不全,请重新上传图片
FailedOperation.ImageBodySmall 输入图身体(头顶到脚踝)高度占比不到图片高度的二分之一
FailedOperation.ImageCheckNoBody 输入图未检测到人体
FailedOperation.ImageDecodeFailed 图片解码失败。
FailedOperation.ImageDetectFaceFailed 输入图人脸检测失败
FailedOperation.ImageFaceDetectFailed 人脸检测失败
FailedOperation.ImageManyPeople 输入图中存在多人
FailedOperation.ImageNotSupported 不支持的图片文件。
FailedOperation.ImageRadioExcceed 输入图高宽比未在1.2~2.0范围内
FailedOperation.ImageRatioExcceed 图片高宽比超过限制。
FailedOperation.ImageResolutionExceed 图片分辨率过大。
FailedOperation.ImageSizeExceed base64编码后的图片数据过大。
FailedOperation.InnerError 服务内部错误,请重试。
FailedOperation.JobNotFound 任务不存在。
FailedOperation.JobQueueFull 任务队列已满,请稍后重试。
FailedOperation.KeyPointUndetected 核心关节点未检测到
FailedOperation.ModerationAudioFailed 音频审核失败
FailedOperation.ModerationFailed 内容审核不通过。
FailedOperation.ServerError 系统内部错误。
FailedOperation.SubmitAsspFailed 请求声伴分离失败,请重试。
FailedOperation.TaskNotExist 任务不存在。
FailedOperation.TaskStatusError 任务状态异常。
FailedOperation.TemplateFirstFrameNotDetectFace 模板视频首帧未检测到人脸
FailedOperation.TemplateNotDetectBody 模板视频存在未检测到人体的帧
FailedOperation.VideoDecodeFailed 视频解码失败。
InvalidParameter.TemplateNotExisted 模板不存在
InvalidParameterValue.InvalidAudioDuration 不支持的音频时长。
InvalidParameterValue.InvalidAudioFormat 不支持的音频格式。
InvalidParameterValue.InvalidImageAspectRatio 不支持的图片长宽比。
InvalidParameterValue.InvalidImageFormat 不支持的图片格式
InvalidParameterValue.InvalidImageResolution 图片分辨率超限。
InvalidParameterValue.InvalidImageSize 不支持的图片大小
InvalidParameterValue.InvalidModel 不支持的模型。
InvalidParameterValue.InvalidVideoAspectRatio 不支持的视频宽高比。
InvalidParameterValue.InvalidVideoDuration 视频时长超过限制。
InvalidParameterValue.InvalidVideoFPS 不支持的视频FPS。
InvalidParameterValue.InvalidVideoFormat 不支持的视频格式。
InvalidParameterValue.InvalidVideoResolution 不支持的分辨率。
InvalidParameterValue.NoFaceInPhoto 图片中没有人脸。
InvalidParameterValue.ParameterValueError 参数字段或者值有误。
InvalidParameterValue.StyleNotExist 风格不存在。
InvalidParameterValue.StyleStrengthNotExist 风格化强度参数不存在。
InvalidParameterValue.TooLargeFaceAngle 人脸角度过大。
InvalidParameterValue.TooLowFaceQuality 人脸质量过低。
InvalidParameterValue.TooManyFaces 人脸数量超过1。
InvalidParameterValue.TooMuchFaceOcclusion 人脸遮挡过多。
InvalidParameterValue.TooSmallFaceSize 人脸过小。
InvalidParameterValue.UrlIllegal URL格式不合法。
InvalidParameterValue.VideoSizeExceed 视频大小超过限制。
OperationDenied 操作被拒绝。
RequestLimitExceeded.JobNumExceed 提交任务数超过最大并发。
ResourceUnavailable.NotExist 计费状态未知。