快速接入 Agent
WorkBuddy
WorkBuddy 是桌面 AI 工作助手，支持自定义 API 接入。填入 Yomi API 的地址、密钥与模型 id，即可在 WorkBuddy 中使用平台的对话模型。
前置准备
- 从 WorkBuddy 官网下载对应系统的安装包并完成安装。
- 登录 Yomi API 控制台，在顶部导航「秘钥管理」创建密钥并复制保存，密钥仅创建时可见。
- 确认账户余额充足，不足可在用户中心「在线充值」页充值。
配置 Yomi API
打开 WorkBuddy 设置，进入「模型」页，点击「添加模型」，提供商选择「自定义 / Custom」（弹窗标注仅支持 OpenAI 兼容协议 API），填入以下三项后保存：
- 接口地址：
https://api.yomiapi.com/v1/chat/completions（WorkBuddy 需填写完整的对话接口地址） - API Key：
YOUR_API_KEY（替换为您的密钥） - 模型名称：填模型 id，如
claude-sonnet-5、gpt-5.6-sol；日常轻量任务可用deepseek-v4-flash
模型必须填模型广场中的模型 id（如
claude-sonnet-5），填显示名（如 Claude Sonnet 5）会导致调用失败。完整目录见控制台顶部导航「模型服务」。
开始使用与验证
回到主界面新建对话，选择刚配置的模型，发送一条测试消息。收到正常回复即接入成功；您也可以在 Yomi API 控制台用户中心「用量统计」中看到这笔调用。
常见问题
连接失败或返回 404
检查接口地址是否为 https://api.yomiapi.com/v1/chat/completions：漏掉路径段或重复拼接都会导致请求路径错误。
返回 401 认证失败
密钥填写有误或已被删除，请到「秘钥管理」核对；重新复制粘贴时注意不要带入首尾空格。
提示模型不存在
确认填写的是模型 id 而非显示名；若 id 无误仍报错，检查密钥所属分组是否包含该模型，各分组可用模型以模型广场为准。