# 解决 503 model_unavailable 和 “No available channels”

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

网页版: https://bigmodel.io/zh-cn/docs/error-model-unavailable · 更新于 2026-10-27

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

```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 之后重试。

3. 在[模型目录](https://bigmodel.io/zh-cn/models)里找一个接口相同、价格相近的模型。
4. 如果某个模型长时间不可用，带上 `X-Request-ID` 联系[支持](https://bigmodel.io/support)。

## 常见问题排查

**只有流式请求失败。** 流式输出开始后才失败的请求，会以 `error` 事件结束，而不是返回 503。见 [Upstream request failed](https://bigmodel.io/zh-cn/docs/error-upstream-request-failed)。

**图片或视频任务一直在排队。** 媒体任务是异步执行的。轮询任务状态，不要重复调用创建接口。见[媒体任务](https://bigmodel.io/zh-cn/docs/api-media-tasks)。

## 相关文档

- [从 OpenRouter 迁移](https://bigmodel.io/zh-cn/docs/migrate-from-openrouter)
- [错误码与响应](https://bigmodel.io/zh-cn/docs/errors)
- [Upstream request failed（502）](https://bigmodel.io/zh-cn/docs/error-upstream-request-failed)
