开始前准备
- 已经能打开 WorkBuddy 主界面。
- 已经登录 1A1API 控制台，并复制一个
sk-开头的 API 密钥。 - 这个 API 密钥所属分组已经开通 OpenAI 兼容模型，例如
gpt-5.6-sol。 - 如果网络环境限制外部 API 访问，请先确认能访问主推地址
https://1a1api.top/v1；不稳定时再尝试备用https://1a1api.com/v1。
WorkBuddy 图文接入
WorkBuddy 图文接入
WorkBuddy 接入 1A1API
不要选腾讯云 Token Plan。选择“其他 / 自定义 / Custom”，再填写接口根地址（Base URL）、API 密钥和模型 ID。
截图版本：2026-07-12 的 WorkBuddy 界面；字段位置可能随版本变化 最后验证：2026-07-20
开始前
先选 Custom，再填写四项配置
已经有 1A1API 的 API 密钥时，按这页把当前分组可用模型添加到 WorkBuddy。关键是选择 其他 / 自定义 / Custom，不要走内置平台入口；gpt-5.6-sol 只作为示例。
成功标志
保存后能在模型菜单选中刚添加的模型，并用一句短问题得到正常回复。
提供商选择
其他 / 自定义 / Custom。接口根地址（Base URL）推荐
https://1a1api.top/v1；备用 https://1a1api.com/v1 只在 .top 访问不稳定时尝试。API 密钥粘贴 1A1API 控制台复制的
sk-...，截图和教程里务必打码。模型 ID从当前分组可用列表复制；
gpt-5.6-sol 仅作测试示例。工具调用首次最小测试先不勾选。纯文本成功后，再开启并单独验证。
图片输入 / 思考模式不确定就先不勾。等纯文本调用成功后，再按当前模型能力逐项打开。
WorkBuddy 的自定义模型配置会写入本地配置文件；换电脑、重装客户端或清理本地数据后，可能需要重新添加一次。真正决定能不能调用的是 API 密钥权限、Base URL 和模型 ID。
图 1
点击输入框下方的模型按钮
在 WorkBuddy 主界面找到“自动”或当前模型按钮，点击展开模型列表。
图 2
点击“+ 配置自定义模型”
列表底部就是添加自定义模型的入口，后续 1A1API 模型也会显示在这里。
图 3
打开提供商下拉
默认可能显示腾讯云 Token Plan，不要直接保存，先点右侧下拉箭头。
图 4
选择“自定义 / Custom”
在“其他”下面选择 Custom，这样才能直接填写 1A1API 的 OpenAI 兼容接口。
图 5
填写 1A1API 配置并保存
Base URL 推荐填 https://1a1api.top/v1；截图里的 https://1a1api.com/v1 作为备用地址，只在 .top 访问不稳定时尝试。API 密钥填自己的密钥，模型 ID 从当前可用列表复制，然后点击保存。
图 6
回到模型列表选择刚添加的模型
截图为旧版界面示意；保存成功后，自定义模型会出现在模型菜单里。选中刚添加的模型后发一句短测试即可。
WorkBuddy 测试提示词
Reply with exactly: ok保存后提示 401 或 API 密钥错误怎么办？
重新复制 1A1API 控制台的完整 API 密钥，确认没有多复制空格、换行或省略号。常见原因是密钥填错、被删除或禁用，或者 WorkBuddy 当前会话没有真正使用这个 API 密钥。
提示模型不存在怎么办？
模型 ID 要填当前分组真实可调用的模型。请从控制台或套餐说明复制；如果示例模型不可用，就改成列表里显示的模型 ID。
接口根地址应该用 .com 还是 .top？
默认推荐 https://1a1api.top/v1。如果你的网络访问 .top 不稳定，再尝试备用 https://1a1api.com/v1。不要一开始两个地址来回换，先用主推地址跑通。
能不能打开图片输入或思考模式？
先把纯文本跑通。图片输入、思考模式、工具调用都依赖模型和客户端支持，纯文本成功后再逐项开启，方便定位问题。
参考资料
查看参考文章
WorkBuddy 自定义模型通用流程
本文参考腾讯云开发者社区的 WorkBuddy 自定义模型教程，并替换为 1A1API 的 Base URL、API 密钥和模型 ID。