跳转到主要内容
Chatbox 是一款跨平台聊天客户端，提供桌面应用和移动应用。在桌面端（以及 Android 端），您可以将 Tokios 添加为自定义 OpenAI API 兼容提供商。将其指向裸主机 https://api.tokios.com，粘贴 sk-tok-… 密钥，并使用您的 Tokios 部署名称作为模型——这样 Chatbox 就会与运行在不同硬件上的模型通信，而不是与托管提供商通信。
本页涵盖 桌面端和 Android 端的 Chatbox。iOS 端的 Chatbox 存在一个已知错误：由于其 WKWebView 网络路径中的 CORS 预检问题，带有 Bearer API 密钥的自定义 OpenAI 兼容端点会失败（chatboxai/chatbox#3516）。如果您使用的是 iPhone 或 iPad，请参阅 在手机上使用本地模型，了解在该平台上可用的替代应用。

​
前提条件

连接器已配对

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

模型已注册

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

API 密钥已创建

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

支持的后端

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

​
在 Chatbox 中添加 Tokios 作为自定义提供商

1

打开 Chatbox 的模型设置

在 Chatbox 中，打开 Settings → Model。
2

添加自定义提供商

点击 Add Custom Provider，并选择 OpenAI API Compatible 作为 API 模式。
3

设置 API 主机、路径和密钥

填写提供商字段。Chatbox 会自动附加补全路径，因此只需提供不带 /v1 的裸主机：
这与大多数 OpenAI 兼容客户端相反。Chatbox 的官方文档指出，API 路径默认为 /v1/chat/completions，并会附加到您输入的主机后——如果您在此处粘贴 https://api.tokios.com/v1，Chatbox 将调用错误的路径。
4

将您的部署添加为模型

输入您的公共部署名称，即您在 Models 选项卡中注册的名称，例如 gemma-tunnel。如果 Chatbox 没有自动列出它，请手动输入模型名称。这是 Chatbox 在 model 字段中发送的值；它不是 Ollama、llama.cpp、vLLM 或 LM Studio 的本地模型 ID。
将 gemma-tunnel 替换为您注册的部署名称，将 sk-tok-YOUR_KEY 替换为您自己的密钥。切勿将两者提交到共享配置文件中。

​
Android 上的相同设置

Chatbox 的 Android 应用使用相同的 Add Custom Provider → OpenAI API Compatible 流程，使用相同的裸主机 https://api.tokios.com 值，且不包含 /v1。上述 iOS CORS 问题不会影响 Android。

​
故障排除

Chatbox 发送的 API 密钥缺失、格式错误或已被撤销。确认您粘贴了完整的 sk-tok-… 密钥，没有多余的空格，并在 Keys 选项卡上检查其状态。
Chatbox 发送的模型值与已注册的部署不匹配。确认 Chatbox 中的模型名称与 Models 选项卡上的公共名称完全一致——而不是您的 Ollama/llama.cpp/vLLM/LM Studio 本地模型 ID。如果您在 API 主机中添加了 /v1，导致 Chatbox 调用了错误的路径，也会出现此情况。
该部署的连接器离线或已达到并发上限。检查 Connectors 选项卡——连接器需要显示为 Online，并且运行它的机器需要仍然处于开机且可访问状态。
这符合已知的 Chatbox iOS 错误（#3516）：带有 Bearer 密钥的自定义 OpenAI 兼容端点无法通过 CORS 预检。这不是 Tokios 端的问题。请在桌面端或 Android 端使用 Chatbox，或查看 在手机上使用本地模型 以获取适用于 iOS 的客户端。

​
后续步骤

快速入门

设置连接器，注册部署，并创建您的第一个密钥。

兼容客户端

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