体验中心
体验中国电信星辰大模型效果
开发平台
为企业及开发者提供 AI 模型训练、应用开发等一站式工具与平台，降低开发门槛，加速AI应用落地。
应用产品
汇聚智能体应用、AI应用、大数据、软硬一体等标准化 AI 产品，覆盖多元场景，让 AI 能力从 “构想” 直连 “应用”
解决方案
以 “场景洞察 + 技术融合” 为锚，打造从需求诊断到价值落地的全链路方案，帮企业破解行业痛点，实现智能化转型 “精准突围”。
关于天翼AI
我们是中国电信旗下开展人工智能业务的科技型、能力型、平台型专业公司，致力于成为人工智能领域的国家战略科技力量。
热门搜索
- 超多方言实时语音识别
- AIGC
- 语义大模型
- 智能体平台
收起侧栏展开侧栏
公共信息状态码（新）
最近更新时间: 2026-09-24 11:07:59公共状态码
本文主要介绍调用模型API服务对应的错误码及其错误描述。在调用 API 请求后，可以通过返回的错误码、错误信息及排查建议等进行问题排查。
错误码格式
若请求错误，服务器将以 JSON 格式返回错误信息，错误信息包含：
| 参数名 | 类型 | 说明 |
|---|---|---|
| requestId | String | 请求 ID |
| code | String | 错误码 |
| message | String | 错误描述信息，帮助理解和解决发生的错误。 |
错误示例
例如错误返回：
json
{
"requestId": "6ba7b810-xxxc04fd430c8",
"code": "10011003",
"message": "header [X-APP-ID]不能为空"
}
错误码列表
鉴权认证相关
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 403 | 10011003 | HEADER_APP_ID_NOT_NULL | header [X-APP-ID]不能为空 |
| 403 | 10011004 | HEADER_APP_KEY_NOT_NULL | header [X-APP-KEY]不能为空 |
| 403 | 10011005 | HEADER_AUTHORIZATION_NOT_NULL | header [Authorization]不能为空 |
| 401 | 10011006 | AUTHORIZATION_FORMAT_ERROR | header [Authorization] 签名格式不正确 |
| 401 | 10011007 | AUTHORIZATION_PREFIX_ERROR | header [Authorization] 签名前缀不正确 |
| 401 | 10011008 | AUTHORIZATION_APP_ID_NOT_EQUAL_HEADER_APPID_ERROR | header [Authorization] appId 与 header appId 不一致 |
| 401 | 10011009 | AUTHORIZATION_SIGN_EXPIRED | header [Authorization] 签名已过期 |
| 401 | 10011010 | AUTHORIZATION_SIGN_VERIFY_ERROR | header [Authorization] 签名认证不通过 |
| 403 | 10011011 | APP_ID_IN_BLACK_LIST | 禁止该appid访问 |
| 401 | 10011012 | APP_ID_APP_KEY_VERIFY_ERROR | X-APP-ID,X-APP-KEY校验不通过 |
| 403 | 10011013 | APP_ID_NO_AUTH_PATH | 该appid无访问权限 |
订单与配额相关
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 403 | 10011014 | ORDER_NOT_ACTIVE | 订单未开始或者已过期 |
| 403 | 10011015 | ORDER_NO_AVAILABLE_COUNT | 资源扣减失败,无可用订单 |
| 403 | 10011036 | ORDER_NOT_EXIST | 订单不存在或未下单 |
| 429 | 10011041 | ORDER_NO_BALANCE | 账户无余额或订单已失效 |
协议入口相关
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 401 | 10011021 | PROTOCOL_API_KEY_NOT_NULL | 协议入口 API Key 不能为空 |
| 401 | 10011022 | PROTOCOL_API_KEY_INVALID | 协议入口 API Key 无效 |
| 403 | 10011023 | PROTOCOL_API_KEY_FORBIDDEN | 协议入口 API Key 不可用 |
| 415 | 10011024 | PROTOCOL_UNSUPPORTED_MEDIA_TYPE | 协议入口 Content-Type 必须为 application/json |
| 400 | 10011030 | PROTOCOL_INVALID_REQUEST_BODY | 请求体不是合法JSON |
| 400 | 10011031 | PROTOCOL_MODEL_NOT_NULL | model不能为空 |
| 400 | 10011033 | PROTOCOL_UNSUPPORTED | 协议不支持 |
路由、中转与代理相关
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 403 | 10011019 | ALL_VERSIONS_UNAVAILABLE | 请求版本不可用 |
| 403 | 10011029 | MODEL_NOT_IN_PLAN | 您订阅的Token Plan套餐不包含此模型 |
通用与限流相关
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 413 | 10011000 | REQUEST_CONTENT_TOO_LARGE | 请求体超过阈值 |
| 429 | 10011001 | TOO_MANY_REQUESTS | 请求数太多,请稍后再试 |
内容安全相关
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 500 | 20001 | REQ_SENSITIVE_NOT_PASS | 请求内容包含非法信息 |
| 500 | 20002 | RES_SENSITIVE_NOT_PASS | 返回内容包含非法信息 |
设备协议相关
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 403 | 10011002 | HEADER_DEVICE_UUID_NOT_NULL | header [Device-Uuid]不能为空 |
| 413 | 10011016 | ORDER_DEVICE_REQUEST_FAST | 请求路数太快,请稍后再试 |
| 400 | 10012018 | BILLING_MODE_DEVICE_NO_DEVICE | 计费模式为设备但未传递设备信息,请确认请求参数 |