功能说明
如果返回结果中存在 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 | 账号已欠费。 |