错误码与限流

出错时返回 JSON，包含错误类型、说明和平台请求编号：

{
  "error": {
    "type": "insufficient_balance",
    "message": "账户可用余额不足，请充值后重试。",
    "request_id": "req_01J9..."
  }
}

联系支持时请提供 request_id。错误信息不会包含上游凭据或内部地址。

状态码复制本节链接

限流复制本节链接

限流按层叠加，任何一层达到上限都会返回 429：

• Key 级：创建 Key 时设置的每分钟请求数、tokens 与并发数。
• 账户级：每个账户的总并发上限。
• 上游级：上游平台对每个模型的限流。上游限流时同样返回 429，并尽量带上 Retry-After。

建议在程序里对 429 和 5xx 做指数退避重试，并设置最大重试次数。不要对已经开始输出内容的流式请求自动重放。