> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arouter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型回退

> 指定一个按优先级排列的回退模型列表。如果主模型失败或不可用，ARouter 会自动使用列表中的下一个模型进行重试。

模型回退允许你按优先级顺序指定多个候选模型。如果第一个模型返回错误、超时或不可用，ARouter 会自动使用下一个模型重试。

## 快速开始

```json theme={null}
{
  "model": "openai/gpt-5.4-pro",
  "models": ["openai/gpt-5.4-pro", "openai/gpt-5.4", "anthropic/claude-sonnet-4.6"],
  "messages": [{"role": "user", "content": "Hello"}]
}
```

## 回退行为

| 场景                | 操作            |
| ----------------- | ------------- |
| 主模型返回 `5xx`       | 使用下一个模型重试     |
| 主模型被限流（`429`）     | 使用下一个模型重试     |
| 主模型不可用            | 使用下一个模型重试     |
| 主模型返回 `4xx`（错误请求） | 立即返回错误        |
| 所有模型都失败           | 返回最后一个尝试模型的错误 |

## 识别哪个模型响应了

响应中的 `model` 字段始终反映实际生成响应的模型。

## 定价

你只为**实际响应**的模型付费。失败的尝试**不计费**。

## 与提供商回退结合使用

```json theme={null}
{
  "model": "openai/gpt-5.4-pro",
  "models": ["openai/gpt-5.4-pro", "openai/gpt-5.4"],
  "provider": {"order": ["Azure", "OpenAI"], "allow_fallbacks": true}
}
```

## 使用场景

**高可用生产环境：**

```json theme={null}
{"models": ["anthropic/claude-opus-4.5", "anthropic/claude-sonnet-4.6", "openai/gpt-5.4-pro"]}
```

**成本优化同时保证质量下限：**

```json theme={null}
{"models": ["openai/gpt-5.4:free", "meta-llama/llama-4-maverick:free", "openai/gpt-5.4"]}
```

## 相关

* [提供商路由](/zh/provider-routing)
* [模型路由](/zh/model-routing)
* [可用性优化](/zh/guides/best-practices/uptime-optimization)