跳转到主要内容
Cherry Studio 是一款跨平台桌面客户端（支持 Windows、macOS、Linux），将众多模型提供商整合到一个应用中。将 Tokios 添加为自定义 OpenAI 提供商——指向 https://api.tokios.com/v1，粘贴 sk-tok-… 密钥，并添加您的 Tokios 部署名称作为模型——Cherry Studio 即可与运行在您自有硬件上的模型进行对话，而非使用托管提供商。

​
前提条件

连接器已配对

在您希望 Cherry Studio 访问的模型旁边安装并配对 tokios-connector。

模型已注册

为该模型注册一个部署（公共名称）。

API 密钥已创建

创建一个 sk-tok-… 密钥，可选择将其范围限定为该部署。

支持的后端

确认您的本地后端（Ollama、llama.cpp、vLLM、LM Studio）正在运行。

​
在 Cherry Studio 中添加 Tokios 作为提供商

1

打开模型提供商设置

打开 Settings（设置，齿轮图标），进入 Model Services（模型服务）选项卡。某些版本将其标记为 Model Provider（模型提供商）——由于 Cherry Studio 的文档是从中文翻译而来的，因此确切措辞可能因版本而异。
2

添加提供商

点击 + Add（添加）。在 Add Provider（添加提供商）对话框中，输入 Provider name（提供商名称，例如 Tokios），并将 Provider type（提供商类型）设置为 OpenAI——这是适用于任何通用 OpenAI 兼容端点的设置。
3

设置 API 地址和密钥

填写提供商字段：
请自行将 /v1 包含在 API address（API 地址）中。Cherry Studio 不会可靠地为自定义提供商追加路径，因此请提供完整的 /v1 基础 URL。
4

添加您的部署作为模型

Cherry Studio 不会为自定义提供商自动列出模型——请手动添加一个，使用您注册的 公共部署名称（可在 Models 选项卡中查看），例如 gemma-tunnel。这是 Cherry Studio 在 model 字段中发送的值；它不是 Ollama、llama.cpp、vLLM 或 LM Studio 的本地模型 ID。
将 gemma-tunnel 替换为您注册的部署名称，将 sk-tok-YOUR_KEY 替换为您自己的密钥。切勿将两者提交到共享配置文件中。

​
桌面应用，模型在别处

这种常见场景的解决方案：Cherry Studio 运行在您的笔记本电脑或台式机上，但您想要的模型（比该机器能运行的更大）位于某处的工作站或服务器上。该模型旁边的连接器向 Tokios 发起出站连接，Cherry Studio 调用 https://api.tokios.com/v1 并使用您的 sk-tok-… 密钥。您可以在 Cherry Studio 的 UI 中使用非本地机器上的模型——无需入站端口，无需 VPN。

​
故障排除

Cherry Studio 发送的 API 密钥缺失、格式错误或已被撤销。确认您粘贴了完整的 sk-tok-… 密钥且没有多余的空格，并在 Keys 选项卡上检查其状态。
Cherry Studio 发送的模型值与已注册的部署不匹配，或者 API address（API 地址）缺少 /v1。确认模型名称与 Models 选项卡上的公共名称匹配，并且地址为 https://api.tokios.com/v1。
该部署的连接器离线或已达到并发上限。检查 Connectors 选项卡——连接器需要显示为 Online（在线），并且运行它的机器需要仍然处于运行状态且可访问。

​
后续步骤

兼容客户端

查看其他 OpenAI 和 Anthropic 兼容客户端的基础 URL 和密钥设置。

API 密钥

为团队成员和代理创建、限定范围和轮换 sk-tok-… 密钥。