HiRoute

接入模型

HiRoute 在本机集中管理订阅、API 和本地模型。“模型”页面分两类：“通用模型”负责回答用户、调用工具和完成任务；“决策模型”只负责判断任务难度和评分，接入方法见 智能模型路由。

本文介绍通用模型：怎样接入、怎样把订阅和 API 里的同名模型组合成一条路由，以及怎样限制 API Key 的花费。桌面应用和 Linux Web UI 的操作相同；命令行对应的 compute 命令见 HiRoute CLI。

添加模型

打开“模型 → 通用模型”，选择“添加模型”：

  • 连接订阅：在 HiRoute 中独立登录 Codex 或 Claude Code 订阅。HiRoute 会自动刷新这份登录凭据，不需要保持原生客户端运行。
  • 扫描本机：发现本机已有的 Agent、Codex / Claude Code 订阅和模型配置，直接复用。复用订阅时，登录凭据的刷新仍依赖原生客户端；Codex 只能复用保存在文件中的登录，钥匙串等存储方式请改用独立登录。
  • 新建 API 接入：从模板开始，填写 API Key，读取服务的模型目录后选择要加入的模型。读取目录不会发起付费推理，API Key 只保存在本机。没有合适的模板时，选择“自定义 API”，手动填写地址和协议；代理服务和本地模型也从这里接入。
  • 向已有接入添加模型：复用已保存的端点和凭据，补充同一服务里的其他模型。
  • 浏览免费模型：查看各服务的免费条件和获取 Key 的指引。

保存后，模型显示“接入就绪”，表示它满足进入路由的本地条件，不代表上游推理或工具调用已经验证过。用一次真实请求确认实际效果。

订阅和 API 一起接入

接入 Codex 或 Claude 订阅并完成检查后，可以在同一个表单里填写对应的 OpenAI 或 Anthropic API Key，也可以选择一个已有的 API 接入。留空就只使用订阅。选好模型、保存一次，订阅和 API 两边可用的模型会一起导入。

部分订阅附带按账单周期发放的 API 赠金。这时填写领取赠金的那个组织的 Key，再按下文给这个 Key 设一份花费额度，就能把赠金用在 HiRoute 的请求上。

用同名模型组成一条路由

打开一个模型的详情，选择“创建智能路由”。如果其他接入也提供这个模型，HiRoute 会提示“其他接入点也有这个模型，是否一起加入候选？”：

  • 一起加入候选：当前模型排在第一位，其他接入作为备用。
  • 仅用当前模型：路由里只放这一个模型。

新路由以“固定模型”方式创建，按候选顺序尝试，暂时不可用的候选会被跳过。也可以把模型加入已有路由，已有候选的顺序保持不变，新模型排在后面。保存或发布前，路由不会生效。

这样，订阅和 API 里的同名模型就组成了一条路由：Agent 只用一个模型名，HiRoute 先用订阅，订阅暂时用不了时接着用 API。

限制 API Key 的花费

在 API 接入的详情中打开“API Key 与额度”，为某个 Key 开启“限制 API 花费”，再选择额度方式：

  • 固定金额，用完即止：适合一次性的预算。
  • 定期补充：按天、周、月或年补充，可以设置补充日期、时间和时区。余额规则可选“每期恢复到设定金额，余额不结转”，或“累加，并限制余额上限”。
  • 共用已有额度：多个 Key 共用同一份额度。

“首次可用金额”可以留空，表示从完整金额开始；如果赠金已经用掉一部分，可以填写剩余金额。

额度只估算经过 HiRoute 的花费，不是服务商的账户余额。HiRoute 转发请求前先占用额度，完成后结算。估算依赖模型的单价：请在模型详情的“调整价格”中补齐同一币种的四项单价。缺少单价或额度不足时，HiRoute 会改用其他 Key 或下一个候选。

设置代理

每个 API 接入都有自己的“接入网络设置”，在“连接方式”中选择：

  • 直连（默认）
  • 服务环境代理：沿用 HiRoute 后台服务启动时的代理环境。
  • 手动代理：填写 HTTP / HTTPS 代理地址，以及不经过代理的地址（可选）。localhost 和回环地址总是直连，代理地址不能包含账号或密码。

保存后，新的请求立即使用新设置，进行中的请求保持原来的路径；保存不代表连通性已经验证。复用这个接入的决策模型也遵循同样的设置。代理地址在 HiRoute 服务所在的机器上解析：通过远程 Web UI 配置时，127.0.0.1 指的是服务器本身，不是浏览器所在的电脑。

订阅连接的代理在“模型”页面的“订阅连接代理”中单独设置，可选自动（使用启动时的代理）、直接连接或手动代理。保存后需要重启 HiRoute。

模型资料与新模型推荐

上下文窗口、输出上限等官方模型资料，以及首页“新模型”中的推荐，都由 hiroute.ai 单独维护和发布，本机服务会自动获取经过校验的内容，不需要等应用升级。已发布的路由保留发布时的能力信息；修改模型或重新发布后才会采用新的资料。

供应商可能在同一个模型名下更新模型，资料里的日期不代表接入实际使用的版本。