API 接入
错误处理
HTTP 状态码
同时检查 HTTP 状态码与响应体。错误响应使用请求接口对应的协议格式。
| 状态码 | 含义 | 处理方式 |
|---|---|---|
| 400 | 请求格式、参数有误,或内容被拒绝。 | 检查 JSON、模型和参数取值。 |
| 401 | API Key 缺失或无效。 | 检查鉴权请求头和 Key。 |
| 403 | Key 已停用,或没有模型调用权限。 | 检查 Key 状态和模型权限。 |
| 404 | 模型或可用通路不存在。 | 检查模型名称与请求路径。 |
| 429 | 请求频率或资源限制。 | 降低并发,延迟后重试。 |
| 500 / 503 | 服务错误或暂时不可用。 | 稍后重试。 |
| 504 | 请求超时。 | 检查客户端超时设置,稍后重试。 |
API Key 限额、有效期和 IP 白名单被拒绝时,响应里的 code(或响应头 x-easyx-error-code)是下面这些值。日、周、月额度到下一个周期会重新计算;累计额度不会自动恢复。
| code | 状态码 | 含义 |
|---|---|---|
ERR_API_KEY_EXPIRED | 403 | 这把 Key 已过有效期。延长有效期后再调用。 |
ERR_API_KEY_IP_NOT_ALLOWED | 403 | 调用方 IP 不在白名单内,或无法识别调用方 IP。 |
ERR_KEY_DAILY_CREDIT_EXHAUSTED | 429 | 每日额度已用尽。 |
ERR_KEY_WEEKLY_CREDIT_EXHAUSTED | 429 | 每周额度已用尽。按自然周计算。 |
ERR_KEY_MONTHLY_CREDIT_EXHAUSTED | 429 | 每月额度已用尽。 |
ERR_KEY_TOTAL_CREDIT_EXHAUSTED | 429 | 累计额度已用尽。需要提高上限后才能继续。 |
ERR_KEY_CREDIT_NOT_READY | 503 | 额度暂时算不出来。稍后重试。 |
OpenAI
{
"error": {
"message": "model is required",
"type": "router_error",
"code": "ERR_MODEL_REQUIRED"
}
}Anthropic
{
"type": "error",
"error": {
"type": "router_error",
"message": "model is required"
}
}Gemini
{
"error": {
"code": 400,
"message": "model is required",
"status": "ERROR"
}
}火山方舟
{
"error": {
"code": "ERR_MODEL_REQUIRED",
"message": "model is required"
}
}