文档 · 路由与运营
错误码与限流
所有错误响应体形如 OpenAI：{ error: { type, code, message, details } }。同时附 x-cdgo-* 头方便归因。
§ 01
HTTP 与 code 矩阵
| HTTP | code | 含义 | 建议 |
|---|---|---|---|
| 401 | invalid_api_key | Key 无效或被撤销 | 控制台重新生成 |
| 402 | budget_exceeded | 超出 Key 月度预算 | 提高预算或换 Key |
| 408 | upstream_timeout | 上游超时 | 自动回退已尝试，可重试 |
| 409 | no_route | 无可用路由（全部回退失败） | 放宽 require 或扩大回退链 |
| 413 | payload_too_large | 输入超出模型上下文 | 分片或换大上下文模型 |
| 422 | validation_failed | 请求体不符合 OpenAI 规范 | 看 details 字段 |
| 429 | rate_limited | 命中限速 | 退避重试，参考 Retry-After |
| 451 | compliance_block | 被合规策略拦截 | 查看 x-cdgo-policy 头 |
| 499 | client_closed | 客户端断开（不计费） | 无需处理 |
| 503 | upstream_5xx | 上游服务异常 | 已自动回退，可直接重试 |
§ 02
限流头
429 响应会带上 Retry-After (秒) 与 x-cdgo-rate-limit / x-cdgo-rate-remaining 三个头。客户端建议指数退避（基线 250 ms，最大 8 s，jitter ±20%）。
§ 03
提工单
请把 x-cdgo-request-id 与发生时间附在邮件里发到 support@cdgo.ai。Pro / Enterprise 客户可使用共享 Slack 频道，参考 /pricing。