跳转到主要内容

常见状态码

状态码含义处理建议
200请求成功正常响应
400请求参数错误检查请求体 JSON 格式和参数
401鉴权失败检查 API 令牌是否正确、是否过期
403无权访问确认 API 令牌的分组包含请求的模型和端点,必要时按客户端页面核对协议与 Base URL
404端点不存在检查请求 URL 是否正确
413请求体过大减小请求体大小后重试
429请求频率超限降低请求频率,检查控制台公告或当前限额
500服务器内部错误稍后重试,保留请求 ID 和错误信息
503服务暂时不可用模型暂无可用容量或上游故障,稍后重试或切换模型
524请求超时网络延迟或请求内容过大,检查网络后重试

错误响应格式

{
  "error": {
    "message": "错误描述信息",
    "type": "error_type",
    "code": "error_code"
  }
}

重试建议

  • 4xx 错误(客户端错误):修复请求后重试,无需等待
  • 429:等待后重试,建议使用指数退避
  • 5xx 错误(服务端错误):等待几秒后重试