模型自动智能路由 - 数字先锋API文档

## 智能路由（AI Router）：用“虚拟模型”撬动无限算力，从此告别手动切换

在当今的AI应用开发中，我们常常面临一个棘手的“选择困难症”：是选成本低的模型，还是选效果好的模型？是选响应快的，还是选最稳定的？

如果您的代码里还充斥着 `if/else` 或 `switch` 逻辑来手动切换不同厂商的模型，那您一定知道这有多痛苦——维护困难、策略僵化、故障率高。

**现在，是时候引入“智能路由”了。**

## 什么是智能路由？

**智能路由**是我们API平台推出的核心能力。它允许您将多个实际模型（无论来自OpenAI、DeepSeek、Gemini还是Claude）组合成一个**虚拟模型名**。

![](/uploads/editor/20260719/img_6a5c728ae62307.21700730.png)

在调用API时，您只需填入这个虚拟模型名，系统便会根据您预设的**路由策略**，自动从绑定的模型列表中挑选最合适的模型来响应请求。**您的业务代码零改动，即可实现模型调度智能化。**

> **打个比方：**
> 您创建了一个名为 `gpt-auto` 的路由，并在其中绑定了 `gpt-4o`、`gpt-4.1-mini` 和 `gpt-4.1-nano` 三个模型。当您的应用请求 `model: "gpt-auto"` 时，系统会按策略自动选一个可用模型执行。您无需关心底层调用的是哪个，只管接收结果即可。

![](/uploads/editor/20260719/img_6a5c72a86b3604.35820817.png)

---

## 🚀 快速上手：三步创建您的第一条路由

1.  **点击「新增路由」**：在控制台填写路由名称和您想要的“调用模型名”（如 `my-fast-route`）。
2.  **选择策略与模型**：选定路由策略（见下文详解），并从模型池中勾选一个或多个模型加入列表。
3.  **保存并调用**：保存后，直接在API请求中使用该“调用模型名”即可。

![](/uploads/editor/20260719/img_6a5c7346ad49c9.03894613.png)

---

## ⚙️ 路由策略详解（按需选择）

我们提供了四种核心策略，满足您从“极致省钱”到“极致稳定”的全部场景：

![](/uploads/editor/20260719/img_6a5c72c4cae004.85600388.png)

---

## 🔄 失败自动切换（高可用保障）

再好的模型也有偶尔“罢工”的时候。智能路由内置了**失败自动切换**机制。

- 启用后，如果当前选中的模型调用失败（如超时、返回5xx错误），系统会**自动无缝切换**到列表中的下一个模型重试。
- 您可设置**最大尝试次数**（如3次），直到请求成功或耗尽重试次数。
- **即使单个模型不稳定，您的服务也绝不会中断。** 这对于依赖AI核心业务的场景至关重要。

---

## 📡 API 调用示例（代码零侵入）

路由创建后，您无需修改任何业务逻辑，只需将请求中的 `model` 字段替换为路由的「调用模型名」。

**cURL 请求：**
```bash
curl https://api.cxsee.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-auto",
    "messages": [{"role": "user", "content": "你好"}]
  }'
```

**Python (openai 库)：**
```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cxsee.com/v1",
    api_key="YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="gpt-auto",  # 这里直接填路由的虚拟模型名
    messages=[{"role": "user", "content": "你好"}]
)
```

---

## 💡 注意事项与高级玩法

1.  **计费透明**：实际消耗按**命中模型**的费率计费，路由本身不收取额外费用。
2.  **模型必须启用**：路由中的模型必须在“渠道管理”中处于启用状态，否则会被系统自动跳过。
3.  **一键复制与测试**：点击路由卡片上的模型名可直接复制；使用「测试」功能可一键检测路由内每个模型在当前节点的可用性。
4.  **场景化路由建议**（参考下图经典案例）：
    - **GPT高频低价路由**：适合混合流量，用 `gpt-4.1-nano` 处理简单任务，用 `gpt-4o` 处理复杂推理。
    - **Gemini专属路由**：适合长上下文与多模态理解，从百万token到毫秒响应，一条路由全覆盖。
    - **Claude专属路由**：安全合规选Claude，代码能力行业顶配，适用于企业级稳定输出。

---

![](/uploads/editor/20260719/img_6a5c72f23257d8.41477458.png)

## 总结

智能路由不仅仅是一个模型聚合工具，它是您AI应用的**算力调度大脑**。它让您摆脱了对单一模型供应商的依赖，大幅提升了系统的容错能力，并精细化了成本控制。

**现在就开始创建您的第一条智能路由吧！让调用更聪明，让成本更可控。**

上一篇：令牌智能分组路由下一篇：Seedance 私域素材库