错误码

本文档列出平台 API 常见错误码及其含义，便于快速定位问题。具体原因请以接口返回的 message 或 error 字段为准。

错误码速查表

错误码	说明	处理建议
`1001`	参数错误	检查请求参数是否完整、类型正确、取值合法
`1002`	鉴权失败	检查 API Key 是否合法、有效
`1003`	服务异常	联系平台开发排查
`1004`	余额不足	充值或调整账户额度
`1005`	频次限制	降低调用频率或 Token 用量
`1006`	超过日限额	等待次日重置或申请提升限额
`10133`	厂商侧返回 429 超频	降低调用频率，稍后重试
`10137`	厂商侧返回 400 错误	会在 `error` 字段中透传错误信息，必要时联系平台排查
`10940`	厂商侧返回异常	会在 `error` 字段中透传错误信息，必要时联系平台排查
`10943`	厂商侧返回异常	会在 `error` 字段中透传错误信息，必要时联系平台排查
`11137`	厂商侧返回异常	会在 `error` 字段中透传错误信息，必要时联系平台排查

错误码详情

1001 — 参数错误

请求参数不符合接口要求，可能原因包括：

必传参数缺失

参数类型错误

参数不支持或未授权

参数值不在允许范围内或未授权

messages 长度超过限制

处理建议：对照接口文档核对请求体，并根据返回的 message 修正对应字段。

1002 — 鉴权失败

API Key 鉴权未通过，可能原因包括：

API Key 不合法

API Key 已失效或被禁用

处理建议：确认 API Key 正确、有效，且具备当前接口的调用权限。

1003 — 服务异常

平台内部服务发生异常。

处理建议：记录请求时间与完整返回信息，联系平台开发排查。

1004 — 余额不足

账户余额不足以完成本次调用。

处理建议：充值或调整账户额度后重试。

1005 — 频次限制

触发调用频次或 Token 用量限制，可能原因包括：

短时间内访问频率过高

Token 使用量过大

处理建议：降低调用频率，控制单次请求的 Token 用量，稍后重试。

1006 — 超出日限额

账户当日调用量已超过日限额。

处理建议：等待次日限额重置，或申请提升日限额。检查组织限额、个人限额，任意一项触达后，都会触发限额报错。

10133 — 厂商侧返回 429 超频

上游模型厂商返回 HTTP 429，表示请求频率超限。

处理建议：降低调用频率，增加重试间隔，必要时联系平台确认厂商侧配额。

10137 — 厂商侧返回 400 错误

上游模型厂商返回 HTTP 400，表示请求格式或参数不符合厂商要求。

处理建议：检查请求参数是否符合厂商接口规范，并根据返回的 error 修正。

10940 — 厂商侧返回异常

上游模型厂商返回异常，具体原因见接口返回信息。

处理建议：查看返回的 error 定位问题；若持续出现，联系平台排查。

10943 — 厂商侧返回异常

上游模型厂商返回异常，具体原因见接口返回信息。

处理建议：查看返回的 error 定位问题；若持续出现，联系平台排查。

11137 — 厂商侧返回异常

上游模型厂商返回异常，具体原因见接口返回信息。

处理建议：查看返回的 message 定位问题；若持续出现，联系平台排查。

通用说明

所有错误码均以接口实际返回为准，本文档为常见场景说明。

错误响应通常包含 code（错误码）和 message（详细描述），排查时请以 message 为准。

平台侧错误码（1001–1006）与厂商侧错误码（10133、10137、10940、10943、11137）分属不同层级，请结合返回信息判断问题来源。

错误码速查表#

错误码详情#

1001 — 参数错误#

1002 — 鉴权失败#

1003 — 服务异常#

1004 — 余额不足#

1005 — 频次限制#

1006 — 超出日限额#

10133 — 厂商侧返回 429 超频#

10137 — 厂商侧返回 400 错误#

10940 — 厂商侧返回异常#

10943 — 厂商侧返回异常#

11137 — 厂商侧返回异常#

通用说明#

错误码速查表

错误码详情

1001 — 参数错误

1002 — 鉴权失败

1003 — 服务异常

1004 — 余额不足

1005 — 频次限制

1006 — 超出日限额

10133 — 厂商侧返回 429 超频

10137 — 厂商侧返回 400 错误

10940 — 厂商侧返回异常

10943 — 厂商侧返回异常

11137 — 厂商侧返回异常

通用说明