API 错误解决指南

请求已经发到 API 服务，但服务端没有接受你的身份凭证。优先检查 API Key、请求头、环境变量和 Base URL 是否属于同一个平台。

403 通常表示 API Key 被识别了，但账号、项目、地区、模型或网络环境没有权限执行当前请求。

404 model not found 多数不是网络 404，而是 model 字段、部署 ID、区域或接口类型不匹配。

429 表示请求频率、Token 速率、并发数或短时间突发量超过平台限制。正确做法是降并发、排队、指数退避和减少单次 Token。

timeout 可能来自网络、代理、DNS、服务端处理太慢、上下文过长或你的运行环境超时限制。先定位是连接超时还是读取超时。

insufficient quota 不是代码格式问题，而是账号可用额度、预算上限、账单状态或免费层限制不足。

invalid API key 是 401 的最常见具体原因。重点检查复制完整性、前后空白、环境变量名、Key 所属平台和泄露轮换。

Base URL 错了会伪装成 401、404、timeout、JSON 解析失败或 HTML 响应。先确认协议、域名、/v1 路径和平台兼容模式。