令牌智能分组路由 - 数字先锋API文档

## 令牌智能路由：一次创建，智能调度

在智能路由的基础上，我们进一步将调度能力下沉到了**令牌（Token）** 层面。现在，您不再需要为每个路由单独创建令牌，而是在生成令牌时直接绑定路由策略，实现“**一个令牌，通吃所有模型**”。

![](/uploads/editor/20260719/img_6a5c71db2cad48.67191539.png)

---

## 什么是令牌智能路由？

简单来说，就是在您创建API令牌时，为其绑定一套**路由策略**。此后，使用该令牌发起的每一次API调用，都会自动按照您预设的策略，从所有可用模型渠道中智能选择最优解。

**核心价值：**
- **零代码切换**：无需在请求中指定模型名，令牌自带路由逻辑。
- **策略与令牌绑定**：不同令牌可对应不同策略（如：开发测试用“速度优先”，生产环境用“成功率优先”）。
- **全局兜底**：即使某个渠道不可用，令牌会自动切换至其他可用渠道，确保请求永不落空。

---

## 五大路由策略详解（创建令牌时选择）

在「创建新令牌」页面，您可以在“智能路由”区域选择以下五种策略之一：

---

## 令牌有效期与额度设置

创建令牌时，您还可以精细控制其生命周期与消费上限：

### 1. 有效期设置
- **永不过期**：适用于长期稳定的生产环境。
- **自定义时长**：支持**一个月、一天、一小时**等选项，适用于临时调试、短期活动或敏感场景的时效性管控。

### 2. 额度设置
- 您可以设置该令牌的**可用额度**（如 $10.00），系统会自动换算等价金额。
- 当令牌消耗达到设定额度时，请求将被自动拒绝，防止预算超支。
- 支持**批量创建**（设置“新建数量”），批量生成时名称后会自动添加随机后缀，方便区分管理。

---

## 使用示例：场景化令牌配置

### 场景一：智能客服生产环境
- **策略**：成功率优先
- **有效期**：永不过期
- **额度**：$100.00
- **效果**：确保每一次客户咨询都能得到稳定响应，绝不因模型故障丢请求。

### 场景二：周末批量数据清洗
- **策略**：价格优先
- **有效期**：一天（仅周末使用）
- **额度**：$5.00
- **效果**：用最低成本处理完所有数据，时间可控、成本可控。

### 场景三：新功能灰度测试
- **策略**：智能自动
- **有效期**：一小时
- **额度**：$1.00
- **效果**：快速验证新模型效果，系统自动综合最优选择，用完即止。

---

## 调用方式

使用令牌智能路由后，您的API调用将变得更加简洁：

```bash
curl https://api.cxsee.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "你好"}]
  }'
```

> **注意**：使用绑定了智能路由的令牌时，**无需**在请求体中指定 `model` 字段，系统会自动按令牌策略选择渠道。如需强制指定模型，可使用手动分组策略或在请求中传入 `model` 覆盖。

---

## 总结

**令牌智能路由**将“调度策略”与“访问凭证”合二为一，让您以最轻量的方式获得最智能的模型调度能力。

- ✅ **一个令牌，适配所有模型**
- ✅ **五种策略，覆盖全部场景**
- ✅ **有效期+额度，预算安全可控**

上一篇：让模型直接给出搜索结果回答下一篇：模型自动智能路由