错误处理

数据 API 返回 OpenAI 兼容错误体：{"error":{"type":"…","code":"…","message":"…","param":null}}，不使用控制面封套。

code	HTTP	对客说明	用户动作
invalid_api_key	401	Key 无效、已撤销或已过期	检查 Key；前往 API Keys 创建或轮换
insufficient_credits	402	可用余额不足或余额为负	购买充值包或续购套餐
entitlement_expired	403	套餐已到期	续购套餐
entitlement_model_not_allowed	403	当前套餐或 Key 不允许该模型	查看套餐权益与 Key 模型白名单；换用允许的模型
rate_limited	429	超过 RPM、TPM 或并发限制	降低频率并退避重试；查看 Key 与套餐限制
settlement_degraded	503	服务繁忙	稍后重试；查看状态页
upstream_error	502	模型服务暂时不可用	退避重试或更换模型；查看状态页
invalid_request_error	400	请求参数错误	按错误信息与文档修正

不要把完整错误响应、Key、Prompt 或 Response 写入日志。排查时记录 HTTP 状态、安全错误码和 X-Request-Id。