API 参考
错误处理
识别常见 HTTP 错误，并为超时、限流和上游故障设计重试策略。
当请求失败时，先记录 HTTP 状态码、返回的错误信息和请求时间，再判断是否重试。日志中不应包含完整 API Key 或敏感输入。
常见状态码
| 状态码 | 含义 | 建议 |
|---|---|---|
400 | 请求体或参数无效 | 检查 JSON、模型 ID 和当前协议要求 |
401 | API Key 缺失、无效或已失效 | 检查请求头，必要时轮换密钥 |
403 | 密钥或分组无权访问 | 检查模型分组与账户状态 |
404 | 端点或模型不存在 | 确认 Base URL、路径和模型 ID |
429 | 超过速率、并发或配额限制 | 指数退避后重试，同时降低并发 |
5xx | 网关或上游暂时故障 | 对幂等请求进行有上限的退避重试 |
重试建议
const retryableStatus = new Set([408, 429, 500, 502, 503, 504])
- 使用指数退避并增加少量随机抖动。
- 限制最大重试次数和总耗时。
- 不要自动重试明确的
400、401或403。 - 对可能产生副作用的请求，先确认幂等性。