WorkBuddy 完整接入教程
从官方下载、注册登录，到创建启用路由密钥、添加模型并完成第一次真实调用。 全程只需一把 API Key，每个模型分别填写对应的 QY- 模型 ID。
WorkBuddy 要填写的是完整请求地址 https://api.actuateai.cn/v1/chat/completions， 不能只填写到 /v1。一个启用路由账号可以创建多把密钥； 同一把密钥也可以配置多个模型。
- 1
下载并安装 WorkBuddy
打开 WorkBuddy 官网，按电脑系统选择 Windows x64 或对应的 macOS 版本。 下载完成后按安装向导安装并启动。Windows 版要求 Windows 10 或更高版本。
WorkBuddy 官网 - 2
注册或登录 WorkBuddy
启动客户端后按页面提示完成注册或登录。登录只用于进入 WorkBuddy； 启用路由账号需要在本站单独注册。两个账号可以使用不同手机号，互不影响。
登录完成后先进入主界面，再继续下面的模型配置。 - 3
- 4
打开 WorkBuddy 的“添加模型”
点击客户端左下角账号或设置入口，进入“设置 → 模型”，然后点击右上角“添加模型”。 在提供商列表中选择“自定义 / Custom”。
设置 → 模型 → 添加模型 - 5
填写接口地址、密钥与模型 ID
接口地址粘贴下面的完整地址；API Key 粘贴刚才复制的完整密钥； 模型名称粘贴模型目录里的精确 QY- 模型 ID，例如
QY-qwen-flash。https://api.actuateai.cn/v1/chat/completions
截图中的密钥仅为无效示例，不包含真实凭据 - 6
按模型目录开启高级能力
工具调用、图片输入和思考模式必须以本站模型目录标注为准；不要按模型名称猜测。 “图片输入”表示模型能看图，不等于图片生成；“自定义协议”保持关闭。 输入和输出上限优先选择“使用提供商默认值”。
- 7
保存并完成第一次测试
保存后在新建任务或会话中选择刚添加的模型，先发送一条简短文本确认连通。 成功后再测试图片输入、工具调用或思考模式。增加其他模型时重复第 4—7 步， 接口地址和 API Key 可以保持不变，只替换模型 ID。
建议第一次测试只发送“请回复连接成功”，便于区分配置问题与复杂任务问题。
常见问题排查
- 地址只填到
/v1：改为完整的/v1/chat/completions。 - 401 鉴权失败：重新复制完整密钥，不要复制网站中的脱敏显示文本。
- 400 输出上限过高：改为提供商默认值，或降低 WorkBuddy 的输出上限。
- 模型不能使用：确认模型 ID 完整包含
QY-，且该模型仍处于开放状态。 - 思考或图片开关不可用：核对本站模型目录中的能力标记，再调整 WorkBuddy 高级配置。