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