UnoRouter：大模型 API 聚合与免费模型接入

UnoRouter 是面向多模型调用的大模型 API 聚合平台：用一组接口和 API Key 接入不同供应方的模型，也能直接在网页里进行角色聊天。它适合希望尝试不同模型、接入现有客户端，或减少重复配置的个人开发者与 AI 爱好者。选择前要分清免费模型的限制、付费额度的有效规则，以及实际接收提示词的上游供应方。

通俗解释：UnoRouter 这个网站是干什么用的？

可以把 UnoRouter 理解成连接多个 AI 模型的“统一接线台”。你的程序或聊天客户端先把问题交给 UnoRouter，再由它转给所选模型的可用供应方，最后返回回答。你通常不必为每个模型重新集成一套接口，而是在兼容的配置中更换模型 ID。

它提供的是模型访问与请求路由服务，不是让你在本机训练一个模型。网站还有内置聊天界面：只想体验角色对话时，可以直接使用已接好的免费模型；想把模型接进自己的程序、SillyTavern 或 Janitor AI，则需要走 API 配置路径。

用统一 API 完成第一次模型调用

根据官方快速入门，常见 OpenAI 兼容客户端需要三项信息：API Key、Base URL 和准确的模型 ID。

1. 注册 UnoRouter，在 Tokens 页面创建 API Key。密钥只展示一次，应及时安全保存。
2. 把客户端的 Base URL 设置为 https://api.unorouter.com/v1，填入自己的密钥。
3. 从当前模型目录复制完整模型 ID。要走免费线路，确认名称带有 :free 后缀，不要自行拼写模型名称。
4. 先发送一个简短问题，确认返回回答，再增加上下文或接入更复杂的工作流。直接发送 Chat Completions 请求时，地址为 https://api.unorouter.com/v1/chat/completions。
5. 在实际使用前检查模型页面的上下文长度、输入输出价格和能力标记。免费模型不一定支持工具调用或视觉输入，接口兼容也不代表所有模型能力完全相同。

API Key 可以设置支出上限、到期时间、模型白名单与 IP 限制。Claude Code、Gemini CLI 等使用原生协议的工具，地址规则可能与 OpenAI 客户端不同，应按对应集成文档配置，不能把同一个 Base URL 无差别套用。

Janitor AI 代理接入与站内角色聊天

Janitor AI 的关键区别是代理栏需要完整请求地址，不是仅填 /v1。按官方 Janitor AI 接入指南，进入聊天的 API Settings，添加配置，填写配置名、完整模型 ID、Proxy URL 和 UnoRouter API Key。Proxy URL 使用 https://api.unorouter.com/v1/chat/completions；如果界面有自动追加 /chat/completions 的选项，不要重复追加。保存配置及设置后，进行一次浏览器强制刷新，再测试当前聊天使用的代理配置。

如果不想配置外部客户端，可以先打开站内聊天。免费模型聊天无需账号和密钥，支持角色、用户人设、世界书以及角色卡导入；文档还提供群聊、自定义供应方和备份恢复说明。角色和对话素材较多时，应查看备份方式：聊天历史保存在浏览器，清除浏览器存储也会移除这些本地记录。

自动路由能解决什么，又有哪些边界？

默认路由会尝试当前可用且价格较低的供应方分组，并在出现错误时切换线路。对需要控制访问路线的用户，API Key 可以为特定模型固定供应方分组；这样做也会缩小故障切换范围，固定的分组都不可用时，请求仍可能失败。

因此，“支持自动切换”不等于任何时间都能成功。免费线路可能遇到平台频率限制、上游额度用尽、共享池每日 Token 预算或单次输入大小限制。付费模型没有 UnoRouter 自设的每分钟请求、Token 和并发上限，但仍受上游容量影响。不要把这一点理解成稳定性承诺或无限算力。

免费模型、按量充值与订阅额度怎么选？

截至 2026 年 11 月 13 日，官网公开价格以美元显示，条目标记为“免费增值”。具体支付方式的最低充值额、税费和结算条件应以结账页面为准。

• 免费模型：模型 ID 带 :free 时仅走免费供应方，不扣账户余额。默认限制为每个用户、每个免费模型每分钟 1 次请求，上游还可能叠加其他限制。
• 按量充值：公开页面提供 1 美元起的充值入口；购买余额按所选模型的输入/输出 Token 费率或单次调用费扣除。官方计费文档说明购买余额不过期，这不等于所有赠送或订阅额度都不过期。
• 月度订阅：Starter 为 20 美元/月，页面标示每月 40 美元 API 额度、每周发放 10 美元；Pro 为 50 美元/月，对应每月 100 美元、每周 25 美元；Scale 为 100 美元/月，对应每月 200 美元、每周 50 美元。未使用的周额度不会结转到下一周，不能按可长期囤积的充值余额理解。

订阅还对免费模型的等待时间提供不同程度的减免，但上游容量仍是另一层限制。偶尔测试可先确认免费模型是否满足能力要求；使用付费模型前，则应结合实际 Token 消耗和周额度使用节奏查看当前定价与订阅条件。

提示词会发给谁？商用前需要核对什么？

“聊天记录存在浏览器”只说明历史记录的存储位置，模型推理仍需要把提示词发给上游供应方。UnoRouter 在隐私政策中表示，不使用提示词和回答训练自己的模型；上游供应方可能按各自规则保留输入或用于训练，还可能涉及跨境处理与额外同意。默认自动路由不能当作仅在某一地区处理数据的保证。

当前服务条款写明暂不提供商业客户账号，生成内容的权利也取决于具体模型条款。不要仅凭 API 可调用或代码开源，就推断已获得企业数据处理条件或所有输出的统一商用授权。涉及真实业务、第三方个人信息或敏感资料时，应先核对所选模型及供应方条件。

常见问题

免费模型可以无限调用吗？

不能。:free 表示该线路不扣余额，不表示没有频率、共享额度或输入大小限制。默认每用户、每模型每分钟 1 次请求，部分订阅可减少平台等待，但不能解除所有上游限制。

直接聊天也需要注册和 API Key 吗？

站内免费模型聊天无需账号和密钥；通过 API 或外部客户端调用则需要自己的 UnoRouter API Key。不要把免注册聊天入口理解成匿名 API。

遇到 429 或 503 怎么处理？

429 时按响应中的 Retry-After 等待，或换一个可用模型。503 应结合具体错误判断：get_channel_failed 可能是供应方繁忙或固定分组不可用；model_not_found 则需要检查模型 ID，反复重试同一个错误名称没有帮助。

聊天记录本地保存，是否代表数据不会外传？

不是。回答生成时，输入仍会发送给供应方。本地记录、不用于平台自身训练和上游的数据使用规则，是三个需要分别确认的问题。

官方资源与开发者社区

• 平台文档：查询密钥、模型、错误码与账单规则。
• 模型服务状态：排查当前模型或供应方是否可用。
• 官方 GitHub：查看网关与聊天前端源码，具体许可按各仓库说明核对。
• 官方 Discord 社区：获取接入帮助和社区更新。