平台指南
错误与速率限制
按照状态码与请求上下文排查失败。
常见状态码
| 状态 | 处理方式 |
|---|---|
| 401 | 检查密钥是否完整、启用且未过期。 |
| 403 | 检查模型、路由分组或 IP 限制。 |
| 404 | 检查基础 URL、路径和模型名称。 |
| 429 | 降低并发并按退避策略重试。 |
| 5xx | 记录请求信息并重试；持续失败时提交工单。 |
速率限制
精确限制取决于账户、模型、路由分组和上游渠道。不要假设固定 RPM 或 TPM；以响应、当前策略和控制台日志为准。
重试策略
只对可重试的 429 和临时 5xx 使用指数退避。
为重试设置上限并保留请求关联信息。
不要自动重试认证、权限或无效参数错误。