错误码
HTTP 状态码和错误处理
API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net
错误响应格式
所有错误返回统一的 JSON 格式：
{
"error": {
"message": "错误描述",
"type": "error_type"
}
}状态码
| HTTP 状态码 | 含义 | 处理建议 |
|---|---|---|
400 | 请求参数错误 | 检查 model、messages 等必填字段 |
401 | 认证失败 | 检查 API Key 是否正确且未撤销 |
402 | 余额不足 | 请先充值 |
429 | 请求频率超限 | 降低请求频率，当前限制 60 RPM |
502 | 上游服务错误 | 模型提供方暂时不可用，稍后重试 |
503 | 服务不可用 | 系统维护中，稍后重试 |
重试建议
429-- 使用指数退避重试，最大间隔 60 秒502/503-- 等待 5-10 秒后重试，最多重试 3 次400/401/402-- 不要重试，修正请求参数或账户状态