MaiToken
登录/注册

WorkBuddy

适用场景：

适合希望通过图形界面添加自定义 OpenAI 模型的入门用户。

推荐方式：使用标准 Base URL

  1. 进入设置： 打开 WorkBuddy，单击左下角的设置图标，进入 Settings → Model。

  2. 添加模型： 在自定义模型区域单击 Add、+ 或 Custom。

  3. 选择 Custom： 服务商选择 Custom；协议选择 OpenAI Compatible 或 OpenAI Chat Completions。

  4. 填写 URL： 输入 https://api.maitoken.com/v1 。

  5. 关闭 Custom Protocol： 保持 Custom Protocol 关闭。关闭后，WorkBuddy 会自动拼接标准的 /chat/completions 路径。

  6. 填写 Key 和模型： API Key 填写您自己的 MaiToken Key；Model Name 或 Model ID 填写 <模型ID>。

  7. 设置模型能力： 如果界面询问模型是否支持 Tool Calling 或 Streaming，请根据模型的实际能力开启。如果不确定，可以先开启并测试 Agent 是否正常运行。

  8. 保存配置： 单击 Save，然后在聊天模型选择器的 Custom 分组中选择该模型。

字段 推荐填写
URL https://api.maitoken.com/v1
Custom Protocol 关闭
API Key <你的 MaiToken Key>
Model <模型ID>
只有当 WorkBuddy 不允许保存 Base URL，或者平台明确要求输入完整请求地址时，才需要打开 Custom Protocol。打开后，请将 URL 改为 https://api.maitoken.com/v1/chat/completions 。

配置完成后这样测试

  1. 测试普通对话： 在聊天框中输入“只回复 OK”。如果收到正常回复，说明 API Key、URL 和模型 ID 基本正确。

  2. 测试项目读取： 打开一个测试项目，输入“请读取当前项目目录，只列出一级文件名，不要修改任何文件。”

  3. 测试 Agent： 让 Agent 新建一个名为 test-maitoken.txt 的文件并写入 hello，然后确认文件已经生成。请勿使用真实生产项目进行测试。

常见问题

问题 处理建议
请求地址变成 /v1/v1 URL 中重复填写了 /v1，只保留 https://api.maitoken.com/v1 。
打开 Custom Protocol 后返回 404 开启 Custom Protocol 时，需要填写完整地址 https://api.maitoken.com/v1/chat/completions 。
模型不在列表中 在 Custom 模型管理页面手动填写准确的模型 ID，然后重新打开模型选择器。