解决 503 model_unavailable 和 “No available channels”

BigModel.io 返回 503 model_unavailable、“No available channels” 和 overloaded_error 的含义、通常持续多久，以及如何自动切换到备用模型。

本页目录
  1. 这是什么意思
  2. 怎么解决
  3. 常见问题排查
  4. 相关文档

模型存在，但现在无法处理请求：

json
{ "code": "model_unavailable", "message": "The model `X` is temporarily unavailable. Please retry shortly.", "error": { "message": "The model `X` is temporarily unavailable. Please retry shortly.", "type": "api_error", "code": "model_unavailable" } }

#这是什么意思

报错 原因 能否重试
model_unavailable “temporarily unavailable” 模型暂时没有可用容量 可以，稍等后重试
api_error “No available channels” 模型暂时停售 稍后再试，或换一个模型
overloaded_error 模型服务负载过高 可以，退避重试
billing_service_error 计费检查失败 可以

以上情况都不扣费。

#怎么解决

  1. 退避重试，从几秒开始。大多数情况几分钟内就会恢复。
  2. 切换到备用模型。 传一个模型列表，第一个可用的模型会返回结果：
json
{ "model": "glm-5.3", "models": ["glm-5.3", "deepseek-v4-pro", "kimi-k3"], "messages": [{ "role": "user", "content": "Hello" }] }

备用列表只在模型不存在、已下架或暂不可用时生效，不会在 429 或 502 之后重试。

  1. 在模型目录里找一个接口相同、价格相近的模型。
  2. 如果某个模型长时间不可用，带上 X-Request-ID 联系支持。

#常见问题排查

只有流式请求失败。 流式输出开始后才失败的请求，会以 error 事件结束，而不是返回 503。见 Upstream request failed。

图片或视频任务一直在排队。 媒体任务是异步执行的。轮询任务状态，不要重复调用创建接口。见媒体任务。

#相关文档

更新于 · 以 Markdown 查看