API Reference
错误、状态码与 request_id
错误响应区分请求、认证、额度、限流和上游故障。
先保存 HTTP 状态、error code 和 request_id，再按状态码修复；认证和参数错误不要自动重试。
- 认证错误
- 401
- 额度/权限
- 402 / 403
- 限流
- 429
- 关联
- request_id
状态码矩阵
| 状态 | 含义 | 处理 |
|---|---|---|
| 400 | JSON、字段或模型参数无效 | 修正后再发 |
| 401 | Key 缺失、错误或已停用 | 重新复制 Key 并更新配置 |
| 402 / 403 | 余额或分组权限不足 | 检查控制台中的账户状态 |
| 404 | 路径、模型或能力不存在 | 刷新 /v1/models |
| 429 | 限流或上游暂时不可用 | 读取 Retry-After 后退避 |
| 5xx | 网关或上游暂时失败 | 有限重试并保留 request_id |
最小排查顺序
- 1确认控制台可以登录。
- 2核对账户状态、余额和 API Key。
- 3重新复制 Gateway、Key 与模型 ID。
- 4调用 /v1/models 验证认证。
- 5发送最小非流式 cURL，再回到 SDK 或 IDE。