ERROR HANDLING

先分清错误，再决定是否重试。

无限重试会放大故障和费用。客户端应按状态码分类，并记录请求时间、模型和请求 ID。

状态码	含义	处理建议
`400`	请求格式或参数错误	修正请求，不自动重试。
`401`	密钥无效或缺失	检查 Authorization，不记录完整密钥。
`403`	模型、分组或 IP 无权限	检查密钥限制和出口 IP。
`429`	限流或额度不足	读取错误信息，指数退避或补充余额。
`500–504`	网关或上游异常	有限次数退避重试，并保留请求 ID。

提交支持信息

请求发生时间和时区。
模型 ID、HTTP 状态码和请求 ID。
是否流式、是否重试、影响范围。
不要发送完整 API Key、密码或提示词正文。