统一错误码说明
AMAX Token Router 对上游模型厂商的错误信息进行透传。错误码和错误描述与上游厂商官方一致。
常见错误类型
由于网关透传上游错误，不同模型厂商返回的错误格式可能略有差异。以下罗列 OpenAI 协议下最常见的错误类型：
| HTTP 状态码 | 错误类型 | 说明 |
|---|---|---|
| 401 | invalid_api_key | API Key 无效或缺失 |
| 402 | insufficient_balance | 账户余额不足 |
| 429 | rate_limit_exceeded | 上游厂商频率限制（AMAX 侧无限流） |
| 500 | server_error | 上游服务器内部错误 |
| 503 | service_unavailable | 上游服务暂时不可用 |
错误响应示例
{
"error": {
"message": "You exceeded your current quota, please check your plan and billing details.",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
}注意事项
- AMAX Token Router 自身不做频率限制，如遇 429 错误，是上游厂商触发了限流
- AMAX Token Router 自身无统一错误码表，具体错误含义请查阅对应模型厂商的官方文档
- 超时时间与上游一致，如遇超时请检查网络到目标厂商的连通性