❌ 错误码

当 API 请求出错时，响应体中会包含错误码和错误信息，帮助你快速定位问题。

错误响应格式

所有错误响应遵循统一格式，包含业务错误码 error.code 和人类可读的 error.message。
json 
{
  "error": {
    "code": 4001,
    "message": "API Key 无效或已过期"
  }
}

错误码一览

🔐 认证 & 权限

错误码HTTP 状态说明
4001 401 API Key 无效或已过期。请检查 Key 是否正确，或前往控制台重新生成。
4002 402 余额不足。请前往控制台充值后重试。
4003 403 无权访问该资源。请确认 API Key 拥有对应权限。
4004 404 请求的资源不存在。请检查 URL 路径和资源 ID 是否正确。

⚠️ 请求 & 限流

错误码HTTP 状态说明
4029 429 请求过频，已触发限流。请稍后重试，或联系提升限额。
4100 400 请求参数错误。请检查参数格式、类型和必填项。

🔧 服务端

错误码HTTP 状态说明
5001 500 服务内部错误。请稍后重试，若持续出现请联系技术支持。
5002 502 上游渠道不可用。模型提供方暂时无法响应，请稍后重试。
5003 503 暂无可用渠道。所有后端渠道均不可用，请稍后重试。

遇到问题？

如果错误码无法解决你的问题，欢迎联系我们获取技术支持。

前往控制台