错误码与排障

状态	常见原因	建议操作
400 / 422	请求体、模型名或参数与路由不兼容	对照协议文档，移除未支持的可选字段并确认模型名。
401	Key 缺失、无效、已撤销或认证头错误	检查 Authorization: Bearer / x-api-key，不要在日志中打印密钥。
403	Key 无对应分组、模型或路由权限	在控制台确认 Key、分组、订阅和模型可见性。
404	路由或 base URL 错误	OpenAI 用 /v1 Base URL；Anthropic SDK 通常使用站点根地址。
429	并发、速率、余额或上游限额触发	遵从 Retry-After（若存在），采用指数退避和客户端排队。
5xx	临时网关或上游故障	仅对安全可重试的请求有限重试，保留请求 ID 和时间范围。

提交客服信息

请提供时间（含时区）、请求 ID、路由、模型、HTTP 状态、已脱敏的错误摘要和最小可复现负载。不要提供 API Key、密码、验证码、身份证明、完整用户对话或支付凭据。

避免重复扣费

超时不等于请求没有被上游处理。对有副作用或长生成请求，先在业务层使用你自己的幂等 ID、任务记录和结果状态；只有能确认未提交时才安全重放。