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

# 路由

> 选择处理请求的账号，配置备用模型并排查路由失败

路由用于管理多个托管账号和备用模型。先完成 [账号托管](https://docs.okab.ai/byoo.md)；新连接的账号进入 **默认组**，不需要分组隔离时可直接使用。

## 分配账号与密钥

每把托管访问密钥绑定一个账号分组，请求只使用组内账号。每个账号只属于一个分组。

1. 打开 [路由 → 账号分组](https://console.okab.ai/byoo/routing?tab=groups)，点击 **新建账号分组**。
2. 填写 **名称**，选择账号、密钥和 **负载策略**，点击 **创建**。
3. 已有分组通过 **编辑** 调整。把账号移到新分组，会使原分组不再使用它；密钥改绑后无需修改客户端配置。

| 负载策略 | 适用情况 |
| - | - |
| **均衡轮询** | 希望优先使用负载较低的账号 |
| **权重优先** | 希望按设置的权重分配新会话 |
| **用量优先** | 希望优先使用剩余额度较多的账号 |

同一会话通常沿用原账号，不可用时才尝试切换。移出分组的账号、密钥会回到默认组；删除分组也会将它们移回默认组。

## 配置备用模型

在 [路由 → 模型分组](https://console.okab.ai/byoo/routing?tab=models) 点击 **新建模型分组**，选择调用模型和工作模型，再选择切换方式：

| 设置 | 效果 |
| - | - |
| **原厂模型名** | 沿用已有模型名，客户端无需改名 |
| **自定义模型名** | 客户端需改为请求这个自定义名称 |
| **故障降级** | 优先使用第一个工作模型，不可用时依次尝试后面的模型 |
| **合并调度** | 所有工作模型的可用账号一起参与调度 |

工作模型最多 8 个，故障降级按列表顺序使用。模型分组对所有账号分组生效，但不会突破密钥的账号分组范围，也不会增加模型权限或上游额度。

## 验证与排查

发起一次客户端请求后，打开 [调试](https://console.okab.ai/byoo/routing?tab=preview)，查看实际使用的账号、模型和切换原因；历史请求可 **重放**。

* 无可用账号：检查密钥绑定分组中的账号是否已启用、授权有效且有额度。
* 没有换模型：检查请求的名称是否匹配模型分组，备用模型是否有可用账号。
* 设置未生效：等待 **正在生效** 提示消失，再发起新请求。
* 没有 **路由** 菜单：当前账号尚未开放该功能。

需要完整操作演示，可打开路由页右上角的 **说明**。计费方式仍按 [账号托管](https://docs.okab.ai/byoo.md) 执行。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.