跳到主要内容

WorkBuddy 接入 FluxLane API

本文档介绍在 WorkBuddy 桌面客户端中通过自定义模型接入 FluxLane API 的完整步骤,配置完成后可在 WorkBuddy 的对话及 Agent 工作流中调用 GPT、Claude、DeepSeek、Kimi、GLM 等模型。

准备工作​

  • WorkBuddy 桌面端:从官网 workbuddy.cn 下载安装。国内版使用微信扫码登录;国际版使用 Google 账号或邮箱登录。

  • Fluxlane 账号:在 fluxlane.ai 注册,用于创建 API Key、查看可用模型及管理用量。

创建 FluxLane API Key​

  1. 登录 Fluxlane 控制台,左侧导航进入「API 密钥」,创建新的 API Key。

  2. 立即复制并保存 Key(以 sk- 开头),后续配置需要粘贴。

  3. (可选)若需限定该 Key 仅调用特定模型,在创建时的「高级配置 → 模型限制」中选择目标模型 ID(例如 kimi-k3)。

  4. 在 Fluxlane「模型广场」(fluxlane.ai/pricing)确认目标模型的完整模型 Model ID、可用状态及计费信息。配置 WorkBuddy 时必须使用模型广场中的模型 ID,不可照搬模型展示名称。

在 WorkBuddy 中添加 FluxLane 自定义模型​

第 1 步:打开自定义模型配置入口​

在 WorkBuddy 主界面点击底部输入框附近的模型选择器,在列表最底部选择「配置自定义模型」。也可从左下角头像进入「设置 → 模型」,到达同一配置页。

第 2 步:添加模型,提供商选“自定义”​

在「模型」设置页点击右上角「+ 添加模型」。「提供商」下拉列表选择最后一项「自定义 / Custom」。选择后,接口地址、API Key、模型名称三个字段需全部手动填写。

第 3 步:填写 FluxLane 配置​

WorkBuddy 要求填写完整的 Chat Completions 端点,必须以 /chat/completions 结尾,而非仅填写 Base URL。

注意:WorkBuddy仅支持v1/chat/completion接口,在调用Claude模型时,由于Claude模型的原生接口是v1/message,所以cache control缓存控制有可能不生效。这是已知官方局限,用户在使用WorkBuddy时谨慎选择Claude模型,否则会因缓存无法生效造成原价计费。(2026.11月更新)

三个字段按以下值填写:

字段填写内容
接口地址https://run.fluxlane.ai/v1/chat/completions
API KeyFluxlane 控制台创建的 Key(sk- 开头)
模型名称Fluxlane 模型广场复制的完整模型 ID(如 openai-gpt-5.2-pro)

第 4 步:保存并切换到新模型​

  1. 点击「保存」。保存仅代表配置已存储,不会自动切换当前对话的模型。

  2. 回到对话页面,点击输入框底部或右下角的当前模型名称,在「自定义模型」列表中找到刚添加的 Fluxlane 模型并选中(名称旁出现勾选标记),后续请求才会经 FluxLane 路由。

  3. 发送一条简短消息(如“你好,请回复 OK”)做连通性验证。正常收到回复即表示接入成功。可在 Fluxlane 后台「使用日志」中确认用量变化。