跳转到主要内容
您的模型会原封不动地留在原处——也就是运行 Ollama、llama.cpp、vLLM 或 LM Studio 的计算机上。要通过手机访问模型,请安装支持自定义 OpenAI 兼容端点的聊天应用,将其指向 https://api.tokios.com/v1,并使用您的 sk-tok-… API 密钥。无需 VPN,无需端口转发,也不会暴露您的家庭网络。 本页仅介绍兼容 OpenAI 的 API。很少有移动聊天应用允许设置 Anthropic 基础 URL,因此除非您找到支持此功能的应用,否则请将 ANTHROPIC_BASE_URL 视为桌面/CLI 功能(请参阅使用 Claude Code)。

唯一会让所有设置失败的陷阱:使用 /v1 还是不使用

移动应用对于基础 URL 字段是否需要 /v1 后缀并不一致:
  • 需要包含 /v1 的应用: Maid、Open WebUI、LibreChat。请使用 https://api.tokios.com/v1。
  • 需要裸主机地址并自行附加路径的应用: Chatbox。请使用 https://api.tokios.com(不含 /v1)。
如果弄反,请求会返回 404,或者根本不会离开应用。请检查字段的占位文本——如果其中显示的默认值以 /v1 结尾(例如 https://api.openai.com/v1),请包含 /v1。如果字段仅标记为 API Host,请省略 /v1。

应避免使用的应用

  • iOS 版 Chatbox——请勿使用。一个已经确认但尚未解决的错误(chatboxai/chatbox#3516)会导致使用 Bearer 密钥身份验证的自定义 OpenAI 兼容端点在 iOS 上失败:未经过代理的请求会通过强制执行 CORS 的 WKWebView fetch() 发出,而 Authorization 标头会触发预检 OPTIONS 请求。Tokios(与大多数面向本地的服务器一样)不会按该应用预期的方式响应此请求。Android 版 Chatbox 没有此错误——请参阅下文。
  • Reins 和 Enchanted——请勿使用。这两个应用仅支持 Ollama 原生 API(/api/chat、/api/generate)。Tokios 提供兼容 OpenAI(/v1/chat/completions)和 Anthropic(/v1/messages)的 API,而不是原始 Ollama API。因此,除非未来版本新增 OpenAI 兼容模式,否则这些应用完全无法连接。
下面三个应用都支持自定义端点和 Bearer API 密钥。它们都不是 Tokios 专用应用,因此在依赖它们之前,请先在应用内确认确切的字段标签——这些标签可能随应用版本而变化。

Pal Chat

支持自定义 OpenAI 兼容端点和自带密钥的提供商。

Apollo (by Liquid AI)

可连接使用 OpenAI 兼容格式的本地或自定义 AI 服务器,并允许您为自定义后端指定模型标识符。

3sparks Chat

该应用自称兼容 OpenAI API,可在本地和在线使用。确切字段标签尚未确认。
请勿在 iOS 上使用 Chatbox 完成此操作——请参阅上方的应避免使用的应用。

增强方案:运行托管 Web UI 并将其安装为 PWA

如果您希望使用功能更完整的聊天界面(包括聊天记录、多个部署和系统提示词),而不是专用原生应用,可以在服务器上托管 Open WebUI 或 LibreChat,将其 OpenAI 兼容连接指向 Tokios,然后以 Progressive Web App 的形式安装到手机上:
1

在服务器上配置 Tokios

在 Open WebUI 中:Admin → Settings → Connections → OpenAI API。设置:LibreChat 中的对应设置是服务器端的 OpenAI 兼容自定义端点配置。
2

在手机上安装 PWA

在手机浏览器中打开托管实例的 URL,然后:
  • iOS(仅限 Safari): 点击 Share → Add to Home Screen。
  • Android(Chrome、Firefox、Brave、Edge): 打开浏览器菜单 → Install app / Add to Home Screen。
Tokios 配置完全位于服务器上——您的手机不会直接保存 API 密钥;它只会通过已安装的 PWA 打开托管的 Open WebUI 或 LibreChat 实例。

后续步骤

快速入门

从零开始配置可正常工作的连接器、部署和 API 密钥。

为本地模型添加 API 密钥

在将密钥交给移动应用之前,先将其范围限制为特定部署。