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)。
/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 兼容模式,否则这些应用完全无法连接。
- iOS
- Android
增强方案:运行托管 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。
后续步骤
快速入门
从零开始配置可正常工作的连接器、部署和 API 密钥。
为本地模型添加 API 密钥
在将密钥交给移动应用之前,先将其范围限制为特定部署。