体验中心
体验中国电信星辰大模型效果
本文整理了天翼AI开放平台模型 API 服务对应的公共错误码。调用 API 请求出错时,可通过返回的错误码、错误信息定位问题。
| HTTP状态码 | 分类 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|---|
| 500 | 内容安全 | 20001 | REQ_SENSITIVE_NOT_PASS | 请求内容包含非法信息 |
| 500 | 20002 | RES_SENSITIVE_NOT_PASS | 返回内容包含非法信息 | |
| 400 | 协议入口 | 10011030 | PROTOCOL_INVALID_REQUEST_BODY | 请求体不是合法JSON |
| 400 | 10011031 | PROTOCOL_MODEL_NOT_NULL | model不能为空 | |
| 400 | 10011033 | PROTOCOL_UNSUPPORTED | 协议不支持 | |
| 415 | 10011024 | PROTOCOL_UNSUPPORTED_MEDIA_TYPE | 协议入口 Content-Type 必须为 application/json | |
| 401/403 | 鉴权认证 / 协议入口 | 10011023 | PROTOCOL_API_KEY_FORBIDDEN | 协议入口 API Key 不可用 |
| 401 | 10011021 | PROTOCOL_API_KEY_NOT_NULL | 协议入口 API Key 不能为空 | |
| 401 | 10011022 | PROTOCOL_API_KEY_INVALID | 协议入口 API Key 无效 | |
| 401 | 鉴权认证 | 10010001 | AUTHORIZATION_FORMAT_ERROR | 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] 签名认证不通过 | |
| 401 | 10011012 | APP_ID_APP_KEY_VERIFY_ERROR | X-APP-ID,X-APP-KEY校验不通过 | |
| 401 | 10011055 | PROTOCOL_AUTHORIZATION_PREFIX_INVALID | 协议入口 Authorization 格式必须为 Bearer | |
| 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]不能为空 | |
| 403 | 10011011 | APP_ID_IN_BLACK_LIST | 禁止该appid访问 | |
| 403 | 10011013 | APP_ID_NO_AUTH_PATH | 该appid无访问权限 | |
| 403 | 10011047 | PLAN_CONTEXT_REQUIRED | 当前接口只能通过套餐入口访问 | |
| 403 | 10011053 | NO_AUTH_ACCESS_MODEL | 当前应用无模型[%s]访问权限 | |
| 400 | 设备协议 | 10012018 | BILLING_MODE_DEVICE_NO_DEVICE | 计费模式为设备但未传递设备信息,请确认请求参数 |
| 403 | 10011002 | HEADER_DEVICE_UUID_NOT_NULL | header [Device-Uuid]不能为空 | |
| 413 | 10011016 | ORDER_DEVICE_REQUEST_FAST | 请求路数太快,请稍后再试 | |
| 403 | 订单与配额 | 10011014 | ORDER_NOT_ACTIVE | 订单未开始或者已过期 |
| 403 | 10011015 | ORDER_NO_AVAILABLE_COUNT | 资源扣减失败,无可用订单 | |
| 403 | 10011036 | ORDER_NOT_EXIST | 订单不存在或未下单 | |
| 429 | 10011041 | ORDER_NO_BALANCE | 账户无余额或订单已失效 | |
| 403 | 路由、中转与代理 | 10011019 | ALL_VERSIONS_UNAVAILABLE | 请求版本不可用 |
| 403 | 10011029 | MODEL_NOT_IN_PLAN | 您订阅的Token Plan套餐不包含此模型 | |
| 413 | 通用与限流 | 10011000 | REQUEST_CONTENT_TOO_LARGE | 请求体超过阈值 |
| 429 | 10011001 | TOO_MANY_REQUESTS | 请求数太多,请稍后再试 |
请求错误时,服务器以 JSON 格式返回错误信息,包含以下字段:
| 参数名 | 类型 | 说明 |
|---|---|---|
| requestId | String | 请求 ID |
| code | String | 错误码 |
| message | String | 错误描述信息,帮助理解和解决发生的错误 |
错误返回示例:
{
"requestId": "6ba7b810-xxxc04fd430c8",
"code": "10011003",
"message": "header [X-APP-ID]不能为空"
}