错误排查

​

401 Invalid token

1. 检查请求头是否为 Authorization: Bearer <API_KEY>。
2. 确认没有多余引号、空格或换行。
3. 确认密钥未撤销且属于当前账户。
4. 使用同一密钥调用 /v1/models。

​

403 Request blocked

1. 使用最小 Chat Completions 请求确认基础连接。
2. 逐步加入 system/developer 消息、工具、图片和高级参数。
3. 检查模型是否支持完整请求中的所有字段。
4. 对比 SDK、Agent 框架与 cURL 的实际请求体。
5. 提供请求 ID 以便定位上游拒绝原因。

​

429 Too many requests

1. 降低请求并发。
2. 使用指数退避和随机抖动。
3. 检查账户余额和模型限制。
4. 必要时使用已经验证的备用模型。

​

5xx 或超时

1. 使用有限次数重试。
2. 检查请求体大小和上下文长度。
3. 测试另一个已验证模型。
4. 记录请求 ID、总耗时和重试次数。