Vane
用 TokenMix 作为 OpenAI 供应商，运行自托管 AI 答案引擎。
适合谁
适合想自托管 Perplexity 类搜索问答的用户。它会结合搜索结果和模型生成带来源的答案，适合研究、资料搜集和公开网页问答。
准备 TokenMix 信息
- Provider / 类型: OpenAI Compatible 或 OpenAI
- Base URL:
https://api.tokenmix.ai/v1 - API Key: TokenMix API Key
- Model: TokenMix 模型 ID，例如
<your-model-short-id>
字段怎么理解
- Provider / 类型决定应用按哪套协议发请求。看到 OpenAI Compatible、OpenAI、Custom OpenAI 时，优先选择能填写 Base URL 的选项。
- Base URL 是真正的 API 入口。这里必须填
https://api.tokenmix.ai/v1，不要填 OpenAI 默认地址，也不要漏掉/v1。 - API Key 是 TokenMix 控制台里创建的 Key。它相当于账号凭证，不要放进公开仓库、截图、教程示例或聊天记录。
- Model 是 TokenMix 的模型 ID，不是应用名称。复制时不要带中文空格，也不要把供应商官网模型名和 TokenMix 展示名混用。
- Embedding 只在文档检索、知识库索引、相似度搜索时需要。第一次只测试普通聊天时，可以先不配置 embedding。
安装或打开应用
- 按仓库 README 使用 Docker 或 Node 方式启动。
- 准备搜索服务配置，例如 SearXNG。
- 打开浏览器进入 Vane 设置页。
- 先配置模型供应商，再配置搜索源。
部署方式怎么选
- 最省事本地版: Docker Bundle，内置 Vane 和 SearXNG。
- 已有 SearXNG: 用 Docker Slim 并填写
SEARXNG_API_URL。 - 一键托管: Sealos、RepoCloud、ClawCloud、Hostinger。
- 开发者: Node Local。部署后在 setup screen 里把 OpenAI provider 的 Base URL 改成 TokenMix。
配置 TokenMix
- 添加 OpenAI provider。
- API Key 填 TokenMix API Key。
- Base URL 填
https://api.tokenmix.ai/v1。 - Chat Model 填 TokenMix 聊天模型 ID。
- Embedding Model 填 TokenMix embedding 模型 ID。
- 如果模型列表加载失败，手动输入模型 ID。
第一次测试
请搜索“OpenAI compatible API base URL 是什么”，用中文给出带来源的简短答案。
先运行一次测试。如果成功，再做一个很小的真实流程或文档测试。基础调用跑通之前，不要接生产数据。
测试通过后怎么继续
- 先确认搜索服务能返回结果，再判断模型回答质量。
- 同时配置 chat model 和 embedding model，否则搜索摘要或相关性可能不稳定。
- 如果没有引用来源，先检查搜索后端，不要只换模型。
- 适合公开网页研究，不要直接拿来搜索内部敏感资料。
常见问题
- 401 / unauthorized: Key 错误、复制了空格，或 Key 已失效。
- model not found: 模型 ID 不对，或账号没有该模型权限。
- 请求仍然发到 OpenAI: Base URL 没改成 TokenMix，或选错 provider。
- 输出太短或中断: 减少一次输入内容，或换上下文更大的模型。
真实使用前检查清单
- 先用测试 Key、测试项目、测试文档或手动触发流程验证。不要第一步就接生产仓库或真实客户数据。
- 打开应用日志、浏览器 Network、终端输出或 TokenMix 请求日志，确认请求确实打到
https://api.tokenmix.ai/v1。 - 确认失败时对用户展示的是可理解错误，不要把 API Key、上游报错、内部路径暴露给最终用户。
- 如果应用会自动发邮件、改 CRM、写数据库、运行命令，先改成只输出草稿或只读模式。
- 跑通后再设置团队权限、预算上限和使用规范，避免所有人共用同一个高权限 Key。
新手安全建议
先用临时项目、测试文档或手动触发流程验证。确认能正常回答后，再接真实仓库、真实知识库或生产自动化。涉及删除文件、运行命令、发邮件、改数据库、调用 CRM 的步骤，都要先让它只给计划，不要直接执行。