WorkBuddy 配置教程

在 WorkBuddy 的自定义模型中接入 apizt，使用 OpenAI 兼容的 Chat Completions 接口。本教程按当前桌面客户端界面重新截图，红框标出需要填写或确认的位置，模型示例为 gpt-6-sol。

先准备：安装并登录 WorkBuddy，在 apizt 控制台创建令牌，确认令牌所在分组支持准备使用的模型。模型 ID 和可用分组可在 模型价格页查询。

添加 apizt 自定义模型

第 1 步：打开设置中的模型页

打开 WorkBuddy 设置，点击左侧模型，再点击右上角添加模型。这个页面用于管理自定义模型；已有条目可以通过右侧铅笔图标编辑。

第 2 步：选择其他分组的自定义

展开供应商下拉列表，向下滚动到其他分组，选择自定义。列表中的“自定义 API”是厂商预设分组；接入 apizt 时使用下方“其他”中的“自定义”入口。

第 3 步：填写地址、API Key 与模型名称

第 4 步：确认高级配置并保存

• 工具调用：本例保留界面默认勾选。WorkBuddy 执行工具任务时，还需要模型和令牌通道支持工具调用。
• 图片输入、思考模式：本例保持未勾选。需要这些能力时，先确认所选模型及分组支持，再逐项开启和验证。
• 自定义协议：接入本文的标准 Chat Completions 接口时保持关闭。这个选项用于跳过路径校验和补全，不是接入 apizt 必须开启的开关。
• 输入、输出：先留空，使用提供商默认值。

核对完整接口地址与模型 ID 后，点击右下角保存。

第 5 步：确认模型已保存

返回自定义模型列表，确认出现 gpt-6-sol。需要修改时，点击该行右侧的铅笔图标。界面会自动保存到本地 ~/.workbuddy/models.json，按本文步骤操作即可。

准备使用时，在会话中选择模型

1. 关闭设置，回到 WorkBuddy 主界面。
2. 点击输入框附近当前模型名称或模式，例如快速，打开模型选择器。
3. 在自定义模型中选择 gpt-6-sol，确认当前会话显示所选模型，再发送消息。

保存与选用是两步：保存模型后，会话可以继续保持原来的模型或模式。本文截图展示保存结果；本次整理未点击测试连接、未切换当前会话，也未发起模型请求。

准备验证连接时，用真实令牌保存配置，发送一句简短的文本问题，再查看 apizt 控制台日志中的模型 ID 与状态。文字回答成功后，再分别验证图片输入、思考模式和工具任务。

常见问题

接口地址应该填到哪里？

按本文填写完整地址 https://api.apizt.com/v1/chat/completions，并保持自定义协议关闭。控制台创建令牌和查询模型价格仍使用 api.apizt.com。

为什么保存后仍然显示快速模式？

添加模型只保存配置。准备使用时，打开会话模型选择器，在自定义模型中选择刚保存的 gpt-6-sol。

模型名称能写成自己的昵称吗？

本界面的“模型名称”会用于实际请求。填写 apizt 支持的完整模型 ID，例如 gpt-6-sol；显示的名称也保持这个 ID。

图片、工具和思考选项应该全部打开吗？

按模型和令牌分组的实际能力设置。图中保留默认的工具调用选项，图片输入、思考模式关闭；需要时逐项开启并验证，勾选本身不会增加模型能力。

自定义模型费用在哪里查看？

apizt 自定义模型调用按 apizt 账户计费，在 apizt 控制台查看余额与调用日志。WorkBuddy 内置模型的积分显示不能代替自定义 API 的费用记录。

相关文档

• 创建 apizt 令牌
• 查找模型 ID 与接口协议
• 在线调试接口
• 发起 API 请求
• 密钥与模型权限排错
• WorkBuddy 自定义模型连接排错