一个为所有人的API使用指南
返回官网 ↗
使用指南工具接入教程

WorkBuddy

WorkBuddy 可以在设置里添加自己的模型服务。本篇以桌面端自定义模型为例,不需要先去修改配置文件。

开始前,把三样信息放在手边

已经装好工具即可继续。打开官网「自助服务」,登录后创建或查看自己的 API 密钥,并复制页面提供的 API 地址;从「模型与价格」复制完整模型 ID。别把官网首页、登录密码或模型的宣传名称填进去。确认账户和密钥都有可用额度。

下面的 API_HOST、YOUR_API_KEY、YOUR_MODEL_ID 都是占位文字,使用前逐个换成你的实际信息。地址里 /v1 是否保留,要看本篇要求;不要追加 /chat/completions 或 /responses。示例不会自动连接,也不会自动带入你的密钥。

1. 找到模型设置

打开 WorkBuddy,进入「设置 → 模型」,有些版本叫「模型管理」。在自定义模型区域点击「添加模型」;如果侧边栏收起了,先展开左下角账户菜单。

2. 选自定义,填地址和密钥

提供商选择「自定义 API / 自定义提供商」。接口地址填平台提供的完整 OpenAI 兼容地址,通常保留 /v1;API Key 填你的平台密钥。不要选择其他厂商的预设后只换密钥,也不要在地址末尾拼 /chat/completions。

字段示意 · 非软件截图
Provider
Custom API
Base URL
https://API_HOST/v1
API Key
YOUR_API_KEY
Model ID
YOUR_MODEL_ID

3. 填模型,核对能力

模型名称填写完整模型 ID;若界面有获取模型按钮,可先获取再选。工具调用、图片输入、思考模式等仅勾选实际支持的能力。上下文和最大输出也按模型资料填,不能照抄其他厂商某个模型的参数。普通 OpenAI 兼容接入先保持「自定义协议」关闭。

4. 先开放档位,再在聊天中选择

自定义表单有「支持的思考强度」时,先勾选模型真实支持的档位,默认值可保持自动。保存后回到对话,选择该自定义模型,再从思考强度入口选档。快速/均衡/极致是软件的模型模式,不能直接当成所有自定义模型的思考档位。

5. 保存并切换到新模型

点「保存」,回到新任务,在输入框附近打开模型选择器,选「自定义模型」下刚才添加的模型。保存配置不会保证当前会话已切换。若模型置灰,回到配置补全地址和 API Key;本次测试用一个新会话。

验证一:收到第一条回复

新建一个空的测试文件夹,在工具中选择它作为工作区,再新开一个会话。确认当前选中的是刚添加的提供方和模型,发送下面这句话。收到正常回复且没有错误,才说明基本连接成功;它不能证明所有工具都已接通。测试会产生正常的 API 用量。

请只回复:连接成功。

预期:工具显示模型回复「连接成功」。若是登录页、报错或一直转圈,先查看下方排查表,不要反复发送。

验证二:让它实际读取一个文件

在刚才的测试文件夹里,用文本编辑器新建 hello.txt,内容写「API connection test 27」。保存后发送下面的要求;出现读取权限提示时,只允许访问这个测试文件夹。

请使用文件读取工具打开当前工作区的 hello.txt,告诉我文件内容,不要修改任何文件。

预期:能看到读取 hello.txt 的工具执行记录,回答包含 API connection test 27。只有一段口头回复、没有读取记录,不算工具调用验证成功。确认结束后,可以自行删除这个测试文件夹。

遇到问题,先按现象检查

401 / Invalid API key

确认地址和密钥来自同一个平台,密钥完整、未过期或被禁用。不要把完整密钥发给客服。

404 / model not found

先核对地址是否多写或少写 /v1,再核对模型 ID 和协议;模型列表可见也不代表所有协议都能使用。

429 / quota / balance

查看账户余额、密钥额度和请求频率,按错误提示处理;提高思考强度不能解决额度问题。

能聊天,不能读文件

确认模型支持工具调用、软件给了工作区读取权限,且工具执行过程没有报错。

没有思考强度选项

先检查模型能力声明,再检查当前模型与客户端版本是否支持可调档位。模型支持思考,不一定支持多个强度。

官方说明与适用范围

配置说明核对于 2026-11-08。工具更新后菜单可能变化,以下官方资料可用于核对;教程中的 API 信息始终以本平台当前提供的内容为准。