静觅 ·

在 WorkBuddy 中使用 Ace Data Cloud

💡 原文中文，约2800字，阅读约需7分钟。

📝

内容提要

本文介绍如何在WorkBuddy中接入Ace Data Cloud，通过OpenAI兼容协议使用Claude、GPT等模型。步骤包括获取API Token、填写接口地址和模型ID，并配置高级选项。配置仅本地保存，费用由Ace Data Cloud计费。

🔎

延伸解读

配置要点：Base URL 与自定义协议开关

WorkBuddy 自定义模型默认使用 OpenAI Chat Completions 协议。配置时只需填写 Base URL（https://api.acedata.cloud/v1），并保持“自定义协议”关闭，WorkBuddy 会自动补全 /chat/completions 路径。若填写完整 endpoint 且开启该开关，则会按原样请求，适用于非标准 URL。理解这一机制可避免因路径重复或错误导致连接失败。

模型 ID 选择与能力标记

模型 ID 需从 Coding 配置选择器或实时模型目录中选取当前存在且已验证的 exact model ID，避免使用目录中不存在或未验证的模型，否则请求会被网关拒绝（4xx 错误）。高级配置中的“工具调用”“图片输入”“推理模式”复选框应仅当所选模型明确支持对应能力时勾选，否则可能影响功能或导致异常。

本地存储与费用归属

自定义模型的配置（含 API Key）仅保存在本地 ~/.codebuddy/models.json，不会上传云端，WorkBuddy 仅作为通信链路转发请求。调用费用由 Ace Data Cloud 按实际使用的模型计费，从账户余额扣除；WorkBuddy 侧仅消耗其自身的积分规则。用户需自行管理 API Key 安全及第三方费用。

❓

Q&A

如何在 WorkBuddy 中添加 Ace Data Cloud 作为自定义模型？

打开 WorkBuddy，进入设置 → 模型，在自定义模型区域点击添加模型。在弹出对话框中，提供商选择“自定义 / Custom”，接口地址填写 https://api.acedata.cloud/v1，API KEY 填写你在 Ace Data Cloud 控制台获取的 API Token，模型名称填写从 Coding 配置选择器或实时模型目录复制的 exact model ID。保存后即可在对话界面的自定义模型分组中找到该模型。

WorkBuddy 中接入 Ace Data Cloud 需要哪些信息？

需要三个关键信息：Ace Data Cloud 的 API Token（在控制台获取）、接口地址（Base URL 为 https://api.acedata.cloud/v1）、以及具体的模型 ID（从 Coding 配置选择器或实时模型目录中复制）。

WorkBuddy 中自定义模型的接口地址需要填写完整的 /chat/completions 路径吗？

不需要。保持“自定义协议”关闭，接口地址只填写 Base URL（https://api.acedata.cloud/v1），WorkBuddy 会自动补全标准 /chat/completions 路径。只有当你需要按原样请求非标准完整 URL 时，才填写完整 endpoint 并开启“自定义协议”。

在 WorkBuddy 中配置 Ace Data Cloud 时，API Key 会被上传到云端吗？

不会。根据 WorkBuddy 官方文档，自定义模型的配置（包括 API Key）仅保存在本地 ~/.codebuddy/models.json 文件中，不会上传到云端。WorkBuddy 只作为通信链路将你的输入转发到填写的接口地址。