文档中心>API 中心

错误码

最近更新时间:2024-01-23 01:18:49

我的收藏

功能说明

如果返回结果中存在 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 接口不支持所传地域。

业务错误码

错误码 说明
FailedOperation.FaceBorderCheckFailed 人脸配准点出框错误码。
FailedOperation.FaceExceedBorder 人脸出框,无法使用。
FailedOperation.FaceFusionError 人脸融合失败,请更换图片后重试。
FailedOperation.FaceRectInvalid 人脸框不合法。
FailedOperation.FaceShapeFailed 人脸配准失败。
FailedOperation.FaceSizeTooSmall 人脸因太小被过滤,建议人脸分辨率不小于34*34。
FailedOperation.FuseFreqCtrl 操作太频繁,触发频控。
FailedOperation.FuseImageError 图像处理出错。
FailedOperation.FuseInnerError 服务内部错误,请重试。
FailedOperation.FuseMaterialNotAuth 素材未经过审核。
FailedOperation.FuseMaterialNotExist 素材不存在。
FailedOperation.FuseSavePhotoFail 保存结果图片出错。
FailedOperation.ImageDecodeFailed 人脸检测-图片解码失败。
FailedOperation.ImageDownloadError 图片下载失败。
FailedOperation.ImagePixelExceed 素材尺寸超过1080*1080像素。
FailedOperation.ImageResolutionExceed 图片分辨率过大。建议您resize压缩到3k*3k以内。
FailedOperation.ImageResolutionTooSmall 图片短边分辨率小于64。
FailedOperation.ImageSizeExceed 输入图片base64数据大小超过5M。
FailedOperation.ImageSizeInvalid 图片尺寸过大或者过小;不满足算法要求。
FailedOperation.InnerError 服务内部错误。
FailedOperation.NoFaceDetected 无法检测出人脸, 人脸框配准分低于阈值。
FailedOperation.ParameterValueError 参数字段或者值有误。
FailedOperation.ProjectNotAuth 活动未支付授权费或已停用。
FailedOperation.RequestEntityTooLarge 请求实体太大。
FailedOperation.RequestTimeout 后端服务超时。
FailedOperation.RpcFail RPC请求失败,一般为算法微服务故障。
FailedOperation.ServerError 系统内部错误。
FailedOperation.TemplateFaceIDNotExist 素材人脸ID不存在。
FailedOperation.UnKnowError 内部错误。
FailedOperation.Unknown 未知错误。
InvalidParameterValue.ActivityIdNotFound 未查找到活动id。
InvalidParameterValue.FaceRectParameterValueError 人脸框参数有误或者人脸框太小。
InvalidParameterValue.ImageEmpty 人脸检测-图片为空。
InvalidParameterValue.MaterialIdNotFound 未查找到素材Id。
InvalidParameterValue.NoFaceInPhoto 人脸检测-图片没有人脸。
InvalidParameterValue.ParameterValueError 参数字段或者值有误。
ResourceUnavailable.Delivering 资源正在发货中。
ResourceUnavailable.Freeze 账号已被冻结。
ResourceUnavailable.GetAuthInfoError 获取认证信息失败。
ResourceUnavailable.InArrears 账号已欠费。
ResourceUnavailable.LowBalance 余额不足。
ResourceUnavailable.NotExist 计费状态未知,请确认是否已在控制台开通服务。
ResourceUnavailable.NotReady 服务未开通。
ResourceUnavailable.Recover 资源已被回收。
ResourceUnavailable.StopUsing 账号已停服。
ResourceUnavailable.UnknownStatus 计费状态未知。
ResourcesSoldOut.ChargeStatusException 账号已欠费。