通用步骤

聊天客户端绝大多数支持 OpenAI 兼容协议，接入只需三步：

  1. 在提供商/模型服务里选择 OpenAI 或 OpenAI 兼容。
  2. API 地址（Base URL） 填 <你的网关地址>/v1，API Key 填你的 OpenTokenRouter 密钥。
  3. 填入可用模型 ID（来自 /v1/models 或首页 Live settlement 列表）。

部分客户端支持从官网「下载」页一键导入（见下文各节）。

Cherry Studio

  • 手动：设置 → 模型服务 → 添加 → OpenAI 兼容，填名称、API 地址 <你的网关地址>/v1、API Key 与模型 ID。
  • 一键：官网「下载」页点击 Cherry Studio 的导入链接（cherrystudio:// 协议）自动完成配置。

LobeChat

  • 手动：设置 → AI 服务商 → OpenAI，填 API Key、自定义接口地址 <你的网关地址>/v1 与模型 ID。
  • 一键：官网「下载」页的 LobeChat 官方示例链接（带 ?settings= 参数）打开即配置。

ChatBox

设置 → 模型 → 提供商选择 OpenAI API，API 域名填 <你的网关地址>/v1，API Key 填密钥，再添加模型 ID。

NextChat（ChatGPT-Next-Web）

设置 → 接口地址 填 <你的网关地址>/v1，API 密钥 填你的密钥，模型 填可用模型 ID（可填 default 使用默认模型）。

Open WebUI

管理员 → 设置 → 连接 → OpenAI API：Base URL 填 <你的网关地址>/v1，API Key 填密钥，保存后在模型管理中启用需要的模型。

DeepChat

官网「下载」页点击 DeepChat 导入链接（deepchat://provider/install）一键配置；或手动添加 OpenAI 兼容提供商，Base URL 填 <你的网关地址>/v1。

AionUI

官网「下载」页点击 AionUI 导入链接（aionui://provider/add）一键配置。

OpenCat

官网「下载」页点击 OpenCat 加入链接（opencat://team/join），域名填 <你的网关地址>，token 填你的密钥。

AMA 问天

官网「下载」页点击 AMA 链接（ama://set-api-key）一键设置服务器与密钥。

AI as Workspace

官网「下载」页点击 AI as Workspace 链接（aiaw.app/set-provider）一键写入 OpenAI 兼容提供商。

CC Switch 与 流畅阅读

  • CC Switch：官网「下载」页提供方导入，或在其管理面板添加 OpenAI 兼容提供商。
  • 流畅阅读：使用浏览器扩展自身的 OpenAI 兼容配置，填 <你的网关地址>/v1 与密钥。

常见问题

  • 填了 /v1 还是连不上：确认没有重复拼接（网关根地址 + /v1），并检查地址是否带多余路径。
  • 模型列表为空：部分客户端需要手动填写模型 ID，先从 /v1/models 复制。
  • 401：密钥错误，或密钥未在控制台启用。
  • 无法流式输出：关闭客户端或本地代理的响应缓冲。