功能说明
如果返回结果中存在 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.TaskFinished | 任务已完成。 |
AuthFailure.UserActivated | 用户已激活。 |
AuthFailure.UserInvalidStatus | 用户状态异常。 |
AuthFailure.UserNotFound | 用户无权限。 |
AuthFailure.UserStopArrear | 用户已欠费停服。 |
FailedOperation.AiTemplateNotExist | 匹配的模板不存在。 |
FailedOperation.CategoryExist | 自定义人物分类已存在。 |
FailedOperation.CategoryLevelChanged | 自定义类型层级变化。 |
FailedOperation.CategoryReferred | 自定义人物分类被引用,不能删除。 |
FailedOperation.CustomGroupAlreadyExist | 自定义人物库已存在。 |
FailedOperation.DBConnectionError | 内部DB连接失败。 |
FailedOperation.DownloadFailed | 媒资文件下载失败。 |
FailedOperation.FeatureAlgoFailed | 图片特征提取失败。 |
FailedOperation.GetCAMTokenFailed | 获取CAM临时鉴权失败。 |
FailedOperation.GetTaskListFailed | 获取任务列表失败。 |
FailedOperation.GetVideoMetadataFailed | 获取媒资信息失败。 |
FailedOperation.ImageNumExceeded | 图片数量过多。 |
FailedOperation.MD5Mismatch | MD5不匹配。 |
FailedOperation.MediaAlreadyExist | 媒资文件已经存在。 |
FailedOperation.MediaExpired | 媒资文件已经过期。 |
FailedOperation.MediaInUse | 媒资正在使用。 |
FailedOperation.MediaNotReady | 媒体文件未就绪。 |
FailedOperation.MultipleFacesInImage | 图片中包含多张人脸。 |
FailedOperation.NoFaceInImage | 图片中不包含人脸。 |
FailedOperation.OpenChargeFailed | 计费开通失败。 |
FailedOperation.PersonDuplicated | 人脸库中存在相似的人脸: %!s(MISSING)。 |
FailedOperation.PersonNotMatched | 人脸图片不属于已知人物。 |
FailedOperation.PersonNumExceeded | 自定义人物数量过多。 |
FailedOperation.QualityAlgoFailed | 图片质量分检测失败。 |
FailedOperation.QualityTooLow | 图片质量分过低。 |
FailedOperation.SnapshotDeserializeFailed | 结果快照反序列化失败。 |
FailedOperation.StopFlowFailed | 停止AI工作室任务失败。 |
FailedOperation.TaskAlreadyExist | 存在相同的任务。 |
FailedOperation.TaskNotFinished | 视频分析未完成。 |
FailedOperation.TranscodeFailed | 转码失败。 |
FailedOperation.UploadFailed | 上传文件失败。 |
InternalError.DBConnectionError | 内部DB连接失败。 |
InternalError.DBOperationError | 内部DB操作错误。 |
InternalError.InnerError | 内部错误。 |
InternalError.InternalOverflow | 自定义人物请求超过限制。 |
InvalidParameter.InvalidCategoryId | 自定义人物类型ID不合法。 |
InvalidParameter.InvalidFilePath | 文件路径不合法。 |
InvalidParameter.InvalidImage | 图片不合法。 |
InvalidParameter.InvalidImageId | 图片ID不合法。 |
InvalidParameter.InvalidL1Category | 一级自定义类型不合法。 |
InvalidParameter.InvalidL2Category | 二级自定义类型不合法。 |
InvalidParameter.InvalidMD5 | MD5不合法。 |
InvalidParameter.InvalidMediaId | 媒体ID不合法。 |
InvalidParameter.InvalidMediaLabel | MediaLabel无效。 |
InvalidParameter.InvalidMediaLang | MediaLang无效。 |
InvalidParameter.InvalidMediaName | 媒体名称非法。 |
InvalidParameter.InvalidMediaPreknownInfo | MediaPreknownInfo无效。 |
InvalidParameter.InvalidMediaStatus | 媒资状态不合法。 |
InvalidParameter.InvalidMediaType | MediaType无效。 |
InvalidParameter.InvalidName | 名称不合法。 |
InvalidParameter.InvalidPageNumber | 分页序号不合法。 |
InvalidParameter.InvalidPageSize | 分页大小不合法。 |
InvalidParameter.InvalidParam | 输入字段 %!s(MISSING) 不合法。 |
InvalidParameter.InvalidPersonId | 人物ID不合法。 |
InvalidParameter.InvalidSortBy | 排序字段不合法。 |
InvalidParameter.InvalidSortOrder | 排序方式不合法。 |
InvalidParameter.InvalidTaskId | 任务ID不合法。 |
InvalidParameter.InvalidTaskName | 任务名称不合法。 |
InvalidParameter.InvalidTaskStatus | 任务状态不合法。 |
InvalidParameter.InvalidURL | URL不合法。 |
InvalidParameter.InvalidUin | 用户Uin无效。 |
InvalidParameter.NameTooLong | 名称超过长度限制。 |
InvalidParameter.ParamTooLong | 参数超过长度限制。 |
InvalidParameter.URLNotResolved | 输入URL域名无法解析。 |
InvalidParameter.UnsupportURL | 不支持的URL类型。 |
LimitExceeded.UsageLimitExceeded | 使用量超过限制。 |
RequestLimitExceeded.BatchImportOverflow | 批量导入超过限制。 |
RequestLimitExceeded.ConcurrencyOverflow | 同时发起过多任务。 |
ResourceNotFound.CustomCategoryNotFound | 自定义人物类型不存在。 |
ResourceNotFound.CustomGroupNotFound | 自定义人物库不存在。 |
ResourceNotFound.MediaNotFound | 媒资文件不存在。 |
ResourceNotFound.RecordNotFound | 记录不存在。 |
ResourceNotFound.TaskNotFound | 任务不存在。 |
UnauthorizedOperation.UnauthorizedProduct | 用户未激活该产品。 |
UnsupportedOperation.MediaNotAccessible | 媒资文件不可访问。 |
UnsupportedOperation.TaskNotAccessible | 任务不可访问。 |