通用错误码

适用范围

本页汇总文本、图片、音频、视频、网页等审核 HTTP API 的常见错误码。并非每个接口都会返回以下全部错误码;业务专属错误、参数要求和限额以各接口说明及补充表为准。

请结合 HTTP 状态码与 errorCode 判断错误。例如,HTTP 400 的 2000 表示缺少业务参数,HTTP 401 的 2000 表示缺少鉴权参数。

接口调用成功不代表内容审核通过,仍需读取审核结论或任务状态字段。

通用错误码

HTTP 状态码 错误码 错误消息 说明
200 0 — 请求成功,错误消息通常省略。
400 1002 API Not Found 接口路径不存在,检查请求地址。
400 1003 Bad Request 请求解析失败,检查请求格式及接口参数要求。
405 1004 Method Not Allowed 请求方法或请求头不符合接口要求,检查 HTTP 方法及 Content-Type。
411 1007 Not Content Length 缺少或未正确设置 Content-Length。
401 1102 Unauthorized Client X-AppId 无效,检查项目编号。
401 1106 Missing Access Token 缺少 Authorization 签名。
401 1107 Invalid Token Authorization 签名不正确,检查签名参数、密钥及实际发送的请求体。
401 1108 Expired Token X-TimeStamp 已过期,检查请求时间及客户端时钟。
401 1110 Invalid Client 客户端标识无效或缺失,具体触发条件以接口说明为准;部分接口表示缺少 X-AppId。
400 2000 Missing Parameter 缺少业务必需参数,例如 content、taskId 或 url;具体参数见接口补充表。
400 2001 Invalid Parameter 业务参数格式或取值不符合要求,具体条件见接口说明。
401 2000 Missing Parameter 缺少鉴权参数,例如 X-TimeStamp。
401 2001 Invalid Parameter 鉴权参数格式错误,例如 X-TimeStamp 格式不正确。
429 1104 Out of Rate Limit 请求频率超过限制。限额和计量方式由产品、接口及项目配置决定。
429 1105 Bandwidth limit exceeded 带宽超过限制,具体额度以产品或项目配置为准。

鉴权问题可参考请求签名。请求方法与 Content-Type 应采用对应接口规定的值。