错误排查

先缩小问题，再重试。高频重复提交通常只会放大限流、并发和余额问题。

先收集四项信息

• 请求时间和时区。
• 使用的 API Key 名称，而不是完整密钥。
• 模型 ID、接口路径和完整 HTTP 状态码。
• 已脱敏的错误消息和客户端是否自动重试。

401：认证失败

• 确认请求头为 Authorization: Bearer YOUR_KEY。
• 确认 Key 仍处于启用状态，且没有复制到多余空格或换行。
• 确认 Base URL 与客户端 SDK 的拼接方式正确。

429：请求受限

• 降低并发并启用指数退避，而不是立刻并发重试。
• 检查同一 Key 是否被多个脚本或应用共享。
• 确认当前模型、余额和该 Key 的限制状态。

模型不可用

模型列表会受 API Key、分组和当前上游能力影响。不要使用来自旧教程或其他账号的模型 ID；请以控制台对当前 Key 展示的列表为准。

上游暂时异常

上游服务可能出现短暂波动、排队或网络异常。等待后用短请求重试一次；如果持续失败，请保留错误时间、模型和请求标识后联系支持。