工具集成/WorkBuddy 接入

把 UniGateway 接入 WorkBuddy。

WorkBuddy 接入

WorkBuddy 是一款支持自定义模型供应商的桌面 AI 客户端。通过将 WorkBuddy 接入 UniGateway，你可以在 WorkBuddy 中访问 UniGateway 平台聚合的丰富模型目录，享受灵活的模型选择和具有竞争力的定价。

兼容性说明

UniGateway 完全支持 OpenAI Chat Completions 协议，可以无缝集成到 WorkBuddy 等支持自定义 OpenAI 兼容端点的客户端中。只需将 UniGateway 添加为自定义模型供应商，即可使用所有支持 OpenAI 协议的模型。

注意：OpenAI 协议的 base_url 为 https://api.unigateway.ai/v1。

配置

第 1 步：下载并安装 WorkBuddy

下载并安装 WorkBuddy 桌面客户端。

第 2 步：添加自定义模型

  1. 打开 WorkBuddy，进入 设置 → 模型 页面。
  2. 在模型设置中找到 自定义模型，点击 添加模型。
  3. 在配置对话框中填写以下信息：
    • 提供商： 选择 自定义
    • 接口地址： https://api.unigateway.ai/v1
    • API Key： 填入你的 UniGateway API Key
    • 模型名称： 填入你要使用的模型 ID（例如 gpt-5.5）
  4. 点击 保存。
  5. 保存后，刚才添加的模型会出现在 已保存模型 列表中。

重要： 请确保填入你实际的 UniGateway API Key。你可以在 UniGateway 控制台中获取你的 API Key。

模型名称应与 GET /v1/models 返回的模型 ID 一致 — 参见 模型列表。你可以重复此步骤添加多个模型。

模型推荐

建议添加不同能力和价格档位的模型，以满足各种使用场景：

  • 高性能模型： 如 claude-sonnet-4-6、gpt-4.1
  • 均衡模型： 如 gemini-2.5-pro、grok-3-fast
  • 高性价比模型： 如 deepseek-chat、qwen3-coder-plus

第 3 步：最后验证

在对话界面中选择刚才新增的模型，向 AI 发送一条消息，确认能够成功收到回复。

如果能成功收到回复，则接入完成。你可以在对话界面中随时切换已添加的任意模型。

故障排除

API Key 错误

问题： 添加模型时提示 API Key 无效或未授权

解决方案：

  • 检查 API Key 是否正确复制，避免多余的空格或换行
  • 确认 API Key 已激活且账户余额充足
  • 登录 UniGateway 控制台检查 API Key 状态

模型调用失败

问题： 选择模型并发送消息后返回错误

解决方案：

  • 确认模型 ID 与 GET /v1/models 返回的完全一致 — 一个字符的差异会导致 404
  • 验证接口地址是否正确设置为 https://api.unigateway.ai/v1（注意 /v1 后缀）
  • 检查账户余额是否充足
  • 尝试切换到其他模型，判断问题是否为特定模型所致

连接被拒绝/超时

问题： 无法连接到 UniGateway 端点

解决方案：

  • 验证网络连通性，尝试在浏览器中访问 https://api.unigateway.ai
  • 确保防火墙或代理设置未阻止对 UniGateway 服务器的访问
  • 确认接口地址包含 /v1 后缀

参见