错误分类
| 状态码 | 含义 | 操作 |
|---|---|---|
| 400 / 413 | 输入无效或请求过大 | 修正请求；不要原样重试 |
| 401 | 密钥缺失或无效 | 轮换或修正凭证 |
| 402 | 计费或余额边界 | 解决计费后再重试 |
| 429 | 触发限流 | 遵守 Retry-After 并退避 |
| 5xx | 临时服务或提供方故障 | 有限次数重试 |
重试策略
使用带 Jitter 的指数退避、较小的最大尝试次数和整体 Deadline。保存 request ID 与错误 Body，但必须清除凭证和敏感输入。
Payload 限制
发送前校验字符数、文件数、字节数以及模型兼容性；可读取时，以模型发现接口中的限制为准。Chat 历史不会被静默丢弃：超过网关字节限制时返回
request_too_large，超过模型上下文时返回 context_length_exceeded。