错误码
返回头(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 | 资源无效 | 请求的资源是无效的or model not found; | 检查请求的模型,在模型服务管理的状态是否为开通,若没有开通,或看不到此调用的模型ID,即没有调用权限,可联系大装置客服处理 | 
| 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中的输入内容,尝试更换内容重新请求 |