WorkBuddy 接入 UniKeyX GPT模型

1

进入设置

打开自定义模型

在 WorkBuddy 主界面，点击输入框右下角的当前模型名称，展开模型列表，选择底部的「配置自定义模型」。

WorkBuddy 主界面的完整模型列表，底部红框标出配置自定义模型入口 — 在模型列表底部选择「配置自定义模型」；点击可查看完整原图。

2

令牌与模型

创建 Key 并配置模型

先创建 API Key

访问 www.unikeyx.com，注册并登录，然后按 ChatGPT 配置页的流程创建令牌：

打开「令牌管理」→「添加令牌」。
令牌分组选 CODEX写代码专用 或 CODEX写代码专用-1，任选其一。
创建后复制 API Key，妥善保存，不要发送给他人。

添加令牌时，令牌分组选择 CODEX写代码专用或 CODEX写代码专用-1 — 令牌分组选择红框中的一个；点击图片可放大。

填写并保存模型

回到 WorkBuddy 的「配置自定义模型」，按下表填写：

模型提供商自定义 / Custom

接口地址https://www.unikeyx.com/v1/chat/completions

API Key粘贴刚创建的真实 Key

模型名称从下面四个名称中选择一个，原样填写

gpt-6-luna gpt-6-astra gpt-6-sol gpt-6.1-sol

点击「保存」。如需使用多个模型，每个模型都要单独添加并保存一次；接口地址和 Key 可以相同。

WorkBuddy 自定义模型表单，依次填写提供商、接口地址、API Key 和模型名称 — 以 `gpt-6.1-sol` 为例；点击图片可放大。

3

完成配置

选择已添加的模型

返回 WorkBuddy 主界面，点击输入框右下角的模型名称。在「自定义模型」列表中选择刚保存的模型，发送一条消息确认能正常回复。

WorkBuddy 模型列表中选中已添加的 gpt-6.1-sol — 示例：已添加并选中 `gpt-6.1-sol`。

FAQ

常见问题

400：gpt-6-luna 提示不支持 Function tools

报错示例：status_code=400, Function tools with reasoning_effort are not supported for gpt-6-luna in /v1/chat/completions. To use function tools, use /v1/responses or set reasoning_effort to 'none'.

先检查 API Key 的令牌分组，建议选择 CODEX写代码专用 或 CODEX写代码专用-1。分组不对时，重新创建 Key 并在 WorkBuddy 中替换、保存。

若仍报同样错误，说明当前请求不支持工具调用与思考参数的组合。使用 gpt-6-luna 的工具调用时，可在高级配置中关闭思考，使请求使用 reasoning_effort = none。不要仅凭这条报错把 WorkBuddy 的接口地址改成 /v1/responses；需先确认客户端支持该协议。

WorkBuddy 连接失败

检查模型提供商是否选择「自定义 / Custom」，接口地址是否完整填写为 https://www.unikeyx.com/v1/chat/completions，不要只填网站首页或 /v1，也不要重复添加路径。保存后重新选择模型测试。

401 / Invalid API Key：Key 无效

从 www.unikeyx.com 的「令牌管理」重新复制完整 Key，去掉首尾空格或换行，确认令牌未禁用、未过期。不要使用注册密码或示例字符串代替 Key；替换后点击「保存」。

Model not found：模型不存在或无权限

模型名称按第 2 步原样填写，不要填展示名称、增加空格或自行改写。再检查令牌是否属于上述专用分组，以及账号是否有该模型的使用权限。

保存后找不到模型，或仍在使用原模型

返回主界面，展开输入框右下角的模型列表，在「自定义模型」中选择刚保存的模型。每个模型需要单独添加并保存；列表未刷新时，重新打开 WorkBuddy 后再试。

429、请求过于频繁或额度不足

若提示限流，稍后重试并减少同时发送的请求；若明确提示余额或额度不足，登录 www.unikeyx.com 检查账号余额和令牌额度。不要连续反复点击发送。

仍无法解决？联系技术支持 QQ：2655485，提供报错截图、模型名称和发生时间；不要发送完整 API Key。