错误码
ZBStream 使用标准 HTTP 状态码表达请求结果。错误响应通常包含可读消息，客户端应记录请求时间、模型和状态码。
遇到 429 / 5xx 错误怎么办？
| 错误码 | 说明 | 处理建议 |
|---|---|---|
| 400 | 请求参数或消息格式错误 | 检查 JSON、model 和 messages |
| 401 | API Key 缺失、无效或已撤销 | 检查 Authorization Header |
| 402 | 积分余额不足 | 充值积分后重试 |
| 403 | API Key 未获该模型授权 | 确认 Key 的可用模型范围 |
| 404 | 接口路由不存在 | 确认 Base URL 和请求路径；模型是否可用请先查询 /v1/models |
| 429 | 模型服务商返回限流响应 | 指数退避后重试 |
| 500 | 服务内部错误 | 保留请求信息并稍后重试 |
| 502 | 连接或读取模型服务失败 | 稍后重试或检查渠道配置 |
| 503 | 服务未配置，或模型服务暂不可用 | 稍后重试或检查服务状态 |
| 504 | 模型服务商返回网关超时 | 稍后重试或切换渠道 |
重试建议
- 仅对 429、502、503、504 和网络中断进行有限次数重试。
- 不要自动重试参数错误、鉴权错误或余额不足。
- 为非幂等业务保存自己的请求标识，避免重复处理结果。