# 通道选择与路由策略

来源: https://platform.lyrouter.com/ai_gateway/docs/routing
更新日期: 2026-10-14

每个工作空间有一份智能路由设置，决定网关为一次调用选择哪个通道。同一个模型通常由多个通道提供，平台通道和你的 BYOK 通道都算在内。「多渠道选路策略」决定这些通道的尝试顺序；「默认模型」在请求没写 `model`，或请求的模型全部失败时接手。设置对工作空间内所有 API Key 生效，保存后几秒内同步到网关。

## 工作空间设置

当前账号管理员在工作空间的 **智能路由** 页面修改设置。页面只有一张「通用设置」卡片：

| 设置 | 作用 | 新建工作空间的默认值 | 保存方式 |
| --- | --- | --- | --- |
| 多渠道选路策略 | 直接调用模型 ID 时，该模型的多个通道按什么顺序尝试 | 最低价 | 选择后自动保存 |
| 默认模型 | 请求没写 `model` 时使用；请求的模型全部失败后兜底 | 暂不设置 | 选择或清空后自动保存 |
| Auto 智能路由 | `lyrouter/auto` 的候选模型范围，见[Auto 智能路由](https://platform.lyrouter.com/ai_gateway/docs/auto) | 全部已开通模型 | 在「高级设置」抽屉中点击 **保存 Auto 设置** |

（截图：智能路由中分别设置多渠道排序和默认模型，Auto 高级设置独立打开。）

三项设置分别保存，修改其中一项不会覆盖另外两项。普通成员看不到这个菜单，直接打开页面链接会提示「当前组织角色无权访问该页面」。成员用自己的 API Key 调用时，同样按这些设置选路。

## 模型、通道与凭证

网关先确定模型，再为模型选择通道，最后选择通道下的凭证。服务商代表厂商身份；协议、地址和接入方式属于通道，所以同一家服务商的按量服务和 Coding Plan 是两个不同的通道。一个通道下可以有多个凭证：你的 BYOK 凭证按你在 BYOK 中设置的顺序在前，平台凭证在后。

## 多渠道选路策略

直接调用模型 ID（例如 `deepseek/deepseek-v4-flash`）时，网关按这项设置给该模型的通道排序，再依次尝试：

| 选项 | 日志中的「路由策略」 | 排序方式 |
| --- | --- | --- |
| 最低价 | `cost` | 按预估的单次请求实付价从低到高排序。预估价根据该模型平均每次请求的输入、输出 Token，该通道的缓存命中率和调用时的价格计算；算不出价格的通道排在最后 |
| 负载均衡 | `balanced` | 先按实测延迟排序，再按「API Key + 模型」把调用稳定地分配到一个通道（按平台为通道设置的权重），分到的通道排第一，其余通道按延迟顺序作为回退 |
| 最高吞吐 | `throughput` | 按实测输出速度从高到低排序，没有测量数据的通道排在最后 |
| 最低延迟 | `latency` | 按实测延迟从低到高排序，没有测量数据的通道排在最后 |

- **会话保持**：「最低价」和「负载均衡」会把同一个 API Key 对同一模型的调用保持在同一个通道上，以提高上游提示词缓存的命中率。保持期为 30 分钟，每次调用都会续期；该通道返回 429、408、5xx 或连接失败时改绑到其他通道。缓存优化见[降低成本与优化缓存](https://platform.lyrouter.com/ai_gateway/docs/cost-practice)。
- **自定义服务商优先**：在「负载均衡」「最高吞吐」「最低延迟」下，工作空间自定义服务商的通道没有可比较的平台测量数据，始终排在平台通道前面。
- **适用范围**：这项设置只对直接写模型 ID 的调用生效。[虚拟模型](https://platform.lyrouter.com/ai_gateway/docs/presets)使用自己的「Channel 排序策略」，`lyrouter/auto` 不使用这项设置。
- **不能按请求覆盖**：选项说明中的「单个请求可覆盖此设置」目前没有实现，请求里没有可以覆盖路由的参数。需要让一部分调用使用不同的排序时，为它们创建虚拟模型并设置「Channel 排序策略」。

## 默认模型

默认模型有两个用途：

1. **请求没写模型**：请求体没有 `model`，或写成 `""`、`null` 时，改用默认模型。没有设置默认模型时，这类请求返回 400 `you must provide a model parameter`（`error.code` 为 `missing_model`）。
2. **全部失败后兜底**：请求的模型所有通道都失败后，网关最后尝试默认模型。请求的模型在本工作空间没有开通时，也会由默认模型回答，而不是返回 403。

使用默认模型前请注意：

- **新建工作空间不预填**：新建工作空间默认「暂不设置」。较早创建的工作空间可能已预填 `qwen/qwen3.7-plus`，请在页面上确认；不需要兜底时清空即可。
- **必须在本工作空间可用**：选择框列出平台模型目录，也可以直接输入模型 ID，保存时不检查是否可用。默认模型没有在模型广场开通、也没有可用 BYOK 时，不写 `model` 的请求返回 403 `Model is not available in the model plaza`，兜底也不会发生。
- **只为对话类接口兜底**：图像、视频和语音接口失败后不会改用默认模型。向量（embeddings）请求也会改用默认模型，但默认模型通常是对话模型，结果多为 400 `unsupported_model_api`，所以向量请求请始终写明可用的模型 ID。
- **在日志中确认**：请求由默认模型回答时，[日志](https://platform.lyrouter.com/ai_gateway/docs/logs)详情的「模型（实际）」显示默认模型。

## BYOK 通道规则

在 [BYOK](https://platform.lyrouter.com/ai_gateway/docs/byok) 的使用配置中，可以为某个通道设置两种偏好，它们优先于多渠道选路策略：

- **优先使用此 Channel**：把这个通道排在最前，失败后照常回退到其他通道和默认模型。
- **仅用此 BYOK**：该模型只使用这个通道下的 BYOK 凭证，不使用平台凭证、其他通道或默认模型，全部失败即结束。通过虚拟模型或 `lyrouter/auto` 调用时，被限定的模型失败后仍会尝试下一个候选模型，但整个请求不会再回退到默认模型。

（截图：在 BYOK 使用配置中核对调用范围及优先、独占使用规则。）

## 验证

调整设置后发送一次测试调用，在[查看实际路由](https://platform.lyrouter.com/ai_gateway/docs/route-log)中核对日志详情：「路由追踪」的「路由策略」显示上表中的取值，「模型（实际）」和「服务商」显示最终命中的模型与通道。「全部候选」只是排好序的候选列表，不代表每个候选都被调用过；实际调用记录在「上游调用尝试」中。失败时如何换通道，见[失败重试与备用模型](https://platform.lyrouter.com/ai_gateway/docs/fallback)。