OpenAI 兼容 API 503 “no available accounts” 排错

这个错误到底意味着什么

中转层返回 HTTP 503 与结构化 JSON 响应体。错误短语 no available accounts 出现在上游日志条目 openai_chat_completions.account_select_failed 的 error 字段。RFC 9110 §15.6.4 规定 503 用于服务端当前无法处理请求的场景——包括反向代理后面的账号池耗尽。

失败发生在选号阶段，尚未真正打到任何上游服务商。/v1/models 仍返回 200，因为模型列表路由根本不需要选号；/v1/chat/completions 返回 503，是因为每个候选账号都没通过预检。

中转层日志的实际样貌

以下两条日志来自 2026-08-08T13:25–13:26+08:00，在 monkeytheme.com 上对 /v1/chat/completions 接口、模型 gpt-5.6-sol 调用时记录：

{"service":"sub2api","env":"production","component":"http","request_id":"05217724-bffa-43c7-9904-8ee9a3545057","path":"/v1/chat/completions","method":"POST","component":"handler.openai_gateway.chat_completions","user_id":1,"api_key_id":53,"group_id":9,"model":"gpt-5.6-sol","stream":true,"error":"no available accounts","excluded_account_count":1}

{"service":"sub2api","env":"production","component":"http","request_id":"607353af-0bd0-4a7e-aecd-558db4daf4de","path":"/v1/chat/completions","method":"POST","component":"handler.openai_gateway.chat_completions","user_id":1,"api_key_id":53,"group_id":9,"model":"gpt-5.6-sol","stream":true,"error":"no available accounts","excluded_account_count":0}

excluded_account_count 字段是最关键的信号：

当 excluded_account_count 为 0，运维应直接排查账号池健康；当 ≥ 1，应查看本条之前记录的每个账号的具体排除原因。

与 401 / 429 / 504 的差别

不要把它们笼统当成“接口报错”。每一类都指向不同层，处置方式也不同。

保存一份完整且脱敏的失败证据

curl -sS -D /tmp/headers.txt -o /tmp/body.json \
  https://monkeytheme.com/v1/chat/completions \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"model":"你的_MODEL_ID","messages":[{"role":"user","content":"Reply with OK"}],"max_completion_tokens":16}'

sed -n '1,20p' /tmp/headers.txt
python3 -m json.tool /tmp/body.json

记录 HTTP 状态、JSON error 字符串、（如存在的）request_id 响应头、时间戳、接口与脱敏后的请求结构。工单或截图中不要出现 Bearer Token。如果中转层返回 503，运维可以用你的 request_id 匹配到对应的 account_select_failed 日志条目，进而判断是否走完了切换。

调用方的恢复清单

1. 确认 Base URL 是 https://monkeytheme.com/v1，且 Key 以 sk- 开头。
2. 用同 Key 拉一次 /v1/models。返回 200 即可排除 401 与路由问题。
3. 把并发至少砍半，等待 10–15 秒后再发起一次探针。
4. 用 stream: false 发送一条小请求，确保只收到一条 503 响应和一个干净的 request_id。
5. 如果同一 request_id 在 60 秒后仍返回 503，换一个已知健康池的模型（用 /v1/models 比对）。
6. 若错误仅出现在某模型且持续，向支持人员提供时间、模型名、脱敏响应体与 request_id。

与官方 SDK 的交互

OpenAI 官方 Python 与 Node.js SDK 当前默认对符合条件的 429 和连接错误重试两次。它们当前并不会对 no available accounts 这类 503 重试，因为 503 是网关在说“换上游或等待”，不是 SDK 认为“瞬时传输错误”。紧密的应用层重试循环只会把流量打到一个已经空的账号池上。诊断时把 max_retries 临时设为 0，先拿到一条干净的失败，再恢复有上限的重试策略。

本文没有作出的承诺

/v1/models 成功不能证明任一具体模型的生成容量可用。一次 no available accounts 的 503 并不意味着中转层宕机——中转是健康的，是上游账号池耗尽了。如果同一时间大量模型都返回 503 且均为 excluded_account_count: 0，这才是需要运维介入的池级容量信号。

官方资料与相关教程

• RFC 9110 §15.6.4：503 Service Unavailable。
• RFC 6585 §4：HTTP 429 与 Retry-After 语义。
• OpenAI API 错误代码：当前 4xx/5xx 分类与重试建议。
• OpenAI 速率限制与 Retry-After。
• openai-python 重试说明：官方 SDK 重试行为。
• sub2api 上游：本文所围绕的 account_select_failed 日志条目来源。

常见问题

相关教程