错误码
返回头(Response Header)
请求的返回头部信息中,会包含 HTTP 状态码
和 x-request-id
,用途如下:
HTTP 状态码
:用于标识请求的状态信息,跟返回体错误信息里的error.code
存在映射关系,具体见下方映射关系表x-request-id
:每个请求唯一ID,用于跟踪请求情况及问题排查
返回体(Response Body)
接口调用报错时,返回示例:
{
"error":{
"code": 0, //错误码
"message": "string", //错误信息
"details": [] //错误细节
}
}
其中, code
跟 HTTP 状态码
的映射关系如下:
code | HTTP 状态码 | 解释 | 报错原因 | 解决方案 |
---|---|---|---|---|
- | 200 | 请求成功 | - | - |
- | 302 | 重定向 | - | - |
1 | 408 | 取消调用 | 客户端取消调用; | - |
2 | 500 | 内部错误 | 服务器内部错误; | 稍后重试,或者联系我们 |
3 | 400 | 参数无效 | 请求的参数名不对; 请求的参数值不符合校验规则; | 检查请求参数是否正确 |
4 | 504 | 调用超时 | 服务器内部超时; | 稍后重试,或者联系我们 |
5 | 404 | 资源无效 | 请求的资源是无效的; | 检查请求的相关资源 |
6 | 409 | 资源冲突 | 请求的资源是重复的; | 检查请求参数 |
7 | 403 | 没有权限 | 账户没有访问对应资源权限; | 检查账号具备的接口访问权限(登录“用户控制台-订阅中心”查看),或者检查请求的参数值是否被允许 |
8 | 429 | 超出限制 | 请求的速度太快; 请求的资源数量超过限制; | 调整您的请求,参考每个模块的接口列表里的调用限制,以及接口文档里对于资源的数量限制 |
9 | 400 | 请求失败 | 请求无法在当前系统状态下执行; | 稍后重试,或者联系我们 |
10 | 409 | 并发冲突 | 并发冲突,例如读取/修改/写入错误; | 稍后重试,或者联系我们 |
11 | 400 | 范围无效 | 请求指定的范围无效; | 检查请求参数 |
12 | 501 | 未实现 | 请求的方法/功能未实现; | 检查请求的方法或路径 |
13 | 500 | 内部错误 | 服务器内部错误; | 稍后重试,或者联系我们 |
14 | 503 | 内部错误 | 服务正在维护,暂不可用; | 稍后重试,或者联系我们 |
15 | 500 | 内部错误 | 服务器内部错误; | 稍后重试,或者联系我们 |
16 | 401 | 鉴权失败 | 请求的API鉴权信息不正确,可能是令牌错误,或者生成的 API_TOKEN 过期; | 检查传入的接口鉴权信息是否正确 |
17 | 400 | 参数无效 | 对话生成触发模型上下文长度限制; | 检查messages 中的输入tokens+ max_new_tokens ≤ 模型上下文长度限制 |
18 | 400 | 参数无效 | 输入/输出内容触发平台安全策略; | 检查messages 中的输入内容,尝试更换内容重新请求 |