错误与限流
错误码、重试策略、速率限制与配额。
错误码速查
| HTTP | 含义 | 你该做什么 |
|---|---|---|
| 400 | 请求参数有误 | 检查请求体格式、字段名、模型 ID |
| 401 | 认证失败 | 检查 API Key 是否完整、是否已过期 |
| 403 | 权限不足或余额耗尽 | 确认 Key 有效；检查账户余额 |
| 404 | 路径或模型不存在 | 检查 API 地址后缀；模型 ID 是否在目录中 |
| 429 | 速率限制 | 按 X-RateLimit-Reset 头等待后重试 |
| 500 | 服务端错误 | 稍后重试 |
常见 400 错误
STREAMING_UNPROVEN：该模型路由暂未开放流式。去掉 stream: true 或换模型。
模型不存在：到控制台 → 模型复制确切 ID。
缺少 max_tokens（Anthropic 协议）：加 "max_tokens": 256。
重试策略
可重试：429（等重置）、500（指数退避 1s→2s→4s 最多 3 次）、网络瞬断（直接重试）。
不可重试：400（修正请求）、401（修复 Key）、404（修正地址或模型）。
速率限制
| 响应头 | 含义 |
|---|---|
X-RateLimit-Limit-Requests | 每分钟最大请求数 |
X-RateLimit-Remaining-Requests | 本窗口剩余次数 |
X-RateLimit-Reset-Requests | 距离重置秒数 |