API 参考
错误码
错误响应格式与处理建议
错误响应格式
请求出错时，接口返回对应的 HTTP 状态码，响应体格式如下：
{
"error": {
"message": "Invalid API key provided",
"type": "authentication_error",
"code": "invalid_api_key"
}
}状态码
| 状态码 | 含义 | 处理建议 |
|---|---|---|
| 400 | 请求参数错误 | 检查请求体格式与参数取值，按 message 提示修改 |
| 401 | API Key 无效或缺失 | 检查请求头中的 Key 是否正确、是否已过期 |
| 403 | 无权访问该模型 | 确认该模型已为你的 Key 开通，联系商务开通 |
| 404 | 接口或模型不存在 | 检查请求路径与模型 ID 拼写 |
| 413 | 请求体过大 | 减少输入内容或压缩图片 |
| 429 | 请求频率或额度超限 | 降低并发、稍后重试，或联系我们提升限额 |
| 500 | 服务内部错误 | 稍后重试，持续出现请联系技术支持 |
| 502 | 上游服务异常 | 稍后重试 |
| 503 | 服务暂时不可用 | 稍后重试 |
| 504 | 上游响应超时 | 稍后重试，长文本建议使用流式输出 |
重试建议
- 遇到 429 和 5xx 错误时，使用指数退避重试（如间隔 1 秒、2 秒、4 秒），最多重试 3 次。
- 400、401、403 属于请求本身的问题，重试不会成功，请先修正请求。
- OpenAI 与 Anthropic 官方 SDK 已内置对 429 和 5xx 的自动重试。
联系支持
排查问题时，请提供出错的时间、模型 ID 与返回的错误信息，联系电话：13581932958。