WorkBuddy

WorkBuddy / CodeBuddy 接入 51token

WorkBuddy（原 CodeBuddy）支持通过本地 models.json 添加自定义模型，使用 OpenAI 兼容的 Chat Completions API 接入 51token。

1. 安装并准备

安装并登录 WorkBuddy。
至少打开一次项目目录，让应用创建本地配置目录。
前往 51token.one/keys 获取 API Key。

2. 配置本地模型

创建或编辑用户级配置文件：

text

C:\Users\<你的用户名>\.codebuddy\models.json

若只想对某个项目生效，也可创建项目级配置文件：

text

<你的项目>\.codebuddy\models.json

先将 51token API Key 设为环境变量：

powershell

setx FIFTYONE_TOKEN_API_KEY "<你的 51token API Key>"

然后写入以下配置（将 gpt-5.6-sol / gpt-5.4-mini 替换为你需要的 51token 模型）：

json

{
  "models": [
    {
      "id": "gpt-5.6-sol",
      "name": "GPT-5.6 Sol",
      "vendor": "51token",
      "url": "https://51token.one/v1/chat/completions",
      "apiKey": "${FIFTYONE_TOKEN_API_KEY}",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true,
      "relatedModels": {
        "lite": "gpt-5.4-mini",
        "reasoning": "gpt-5.6-sol"
      }
    },
    {
      "id": "gpt-5.4-mini",
      "name": "GPT-5.4 Mini",
      "vendor": "51token",
      "url": "https://51token.one/v1/chat/completions",
      "apiKey": "${FIFTYONE_TOKEN_API_KEY}",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true
    }
  ],
  "availableModels": [
    "gpt-5.6-sol",
    "gpt-5.4-mini"
  ]
}

请将 models.json 保存为 UTF-8 无 BOM。部分桌面版本读取带 BOM 的 JSON 时会失败。

完整模型名见模型与渠道。url 固定为 https://51token.one/v1/chat/completions（OpenAI Chat Completions 兼容）。

3. 重启并选择模型

完全退出 WorkBuddy 后重新打开。在模型选择器中选择：

text

GPT-5.6 Sol
GPT-5.4 Mini

4. 可选：验证 API Key

Windows 用户可在 PowerShell 验证：

powershell

$env:FIFTYONE_TOKEN_API_KEY="<你的 51token API Key>"

curl https://51token.one/v1/chat/completions `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer $env:FIFTYONE_TOKEN_API_KEY" `
  -d '{"model":"gpt-5.4-mini","messages":[{"role":"user","content":"hi"}],"stream":false}'

请求成功即说明 Key 与模型名可用。

常见问题

Authentication Fails 或 401：检查 apiKey 是否为真实 51token API Key，不要把接口 URL 填到 API Key 字段。
未找到模型 或 404：检查模型 id 是否与 51token 实际模型名严格一致。
读取本地模型配置失败：检查 models.json 是否为合法 JSON，并保存为 UTF-8 无 BOM。
模型选择器不显示：完全重启 WorkBuddy，并确认文件位于 .codebuddy\models.json。
UI 中直接显示 ${FIFTYONE_TOKEN_API_KEY}：请从已设置该环境变量的终端中重启 WorkBuddy；若桌面端不展开环境变量，可在 models.json 中直接填入真实 Key。