错误码
请求失败时，网关返回非 2xx 的 HTTP 状态码及统一的错误响应体。message 末尾通常带有 request id，便于在控制台日志中定位该条记录。
错误结构
{
"error": {
"code": "",
"message": "Error description (request id: 2026053012xxxx)",
"type": "new_api_error"
}
}type 表示错误来源：网关自身，或来自上游厂商的透传。
错误类型
| type | 含义 |
|---|---|
new_api_error | 网关自身的错误（鉴权、余额、限流、参数等） |
upstream_error | 上游厂商返回的错误（包装透传） |
openai_error | OpenAI 协议上游的错误 |
claude_error | Claude 协议上游的错误 |
gemini_error | Gemini 协议上游的错误 |
midjourney_error | Midjourney 任务错误 |
HTTP 状态码
| 状态码 | 含义 | 排查建议 |
|---|---|---|
400 | 请求有误 | 检查 JSON 结构、必填字段，以及 model 是否正确 |
401 | 未鉴权 / 密钥无效 | 检查鉴权请求头和密钥，确认密钥未被删除 |
403 | 无权限 | 该密钥无法访问此模型或分组，确认模型在可用范围内 |
429 | 限流或余额不足 | 降低并发、稍后重试，或检查余额 |
500 | 服务器内部错误 | 携带 request id 联系客服 |
503 | 上游不可用 | 上游暂时不可用，建议重试 |
重试建议
幂等与退避
对于 429 / 500 / 503，请使用指数退避重试。400 / 401 / 403 属于客户端错误——重试无济于事，请先修正请求。