Skypool Token
Token online
Sign up
DocsWorkBuddy 接入

WorkBuddy 接入

使用 WorkBuddy 自定义模型配置接入天池 Token OpenAI 兼容接口。

Updated:

适用场景

WorkBuddy 支持配置自定义模型。你可以把天池 Token 作为 OpenAI 兼容模型提供方接入，让 WorkBuddy 使用平台上的模型完成代码理解、编辑、解释和 Agent 任务。

接入时只需要准备四个值：

配置项值
API KeyConsumer API Key，例如 stc-...
接口地址https://a.skypool.xyz/v1/chat/completions
模型 ID平台模型名，例如 gemma4:26b
模型能力按模型实际能力选择文本、工具调用、图片等能力

方式一：在 WorkBuddy 界面里配置

如果你的 WorkBuddy 版本提供“自定义模型”或“自定义供应商”界面，推荐优先使用界面配置。

按下面的值填写：

字段填写内容
供应商名称Skypool Token 或 天池 Token
模型名称gemma4:26b，或你要使用的平台模型 ID
API KeyConsumer API Key
接口地址https://a.skypool.xyz/v1/chat/completions
协议类型OpenAI 兼容或 OpenAI-compatible

保存后，重启 WorkBuddy 或刷新模型列表，然后在模型选择器里选择刚刚添加的模型。

方式二：使用本地配置文件

如果你的版本支持本地 JSON 配置，可以在用户级或项目级配置里加入天池 Token 模型。

常见配置位置如下：

范围WindowsmacOS / Linux
用户级C:\Users\<用户名>\.workbuddy\models.json~/.workbuddy/models.json
项目级<项目根目录>\.workbuddy\models.json<项目根目录>/.workbuddy/models.json

有些 WorkBuddy 版本沿用 CodeBuddy 配置目录。如果 .workbuddy 不生效，再检查同级的 .codebuddy/models.json 或用户目录下的 .codebuddy/models.json。

示例配置：

JSON
{  "models": [    {      "id": "gemma4:26b",      "name": "天池 gemma4 26B",      "vendor": "Skypool Token",      "url": "https://a.skypool.xyz/v1/chat/completions",      "apiKey": "${SKYPOOL_API_KEY}",      "maxInputTokens": 128000,      "maxOutputTokens": 8192,      "supportsToolCall": true,      "supportsImages": false    }  ],  "availableModels": [    "gemma4:26b"  ]}

如果模型支持图片输入，可以把 supportsImages 改为 true。如果只做普通文本和代码任务，保持 false 更稳妥。

设置环境变量

建议把 API Key 放到环境变量里，配置文件只引用变量。

PowerShell 当前窗口：

PowerShell
$env:SKYPOOL_API_KEY="stc-..."

Windows 持久化：

PowerShell
setx SKYPOOL_API_KEY "stc-..."

macOS / Linux：

Bash
export SKYPOOL_API_KEY="stc-..."

设置后重新打开 WorkBuddy，确保它能读取到新的环境变量。

验证接口

在接入 WorkBuddy 前，先用同一个 Key 和模型跑通一次请求：

Bash
curl -X POST "https://a.skypool.xyz/v1/chat/completions" \  -H "Authorization: Bearer <consumer_api_key>" \  -H "Content-Type: application/json" \  --data-raw '{    "model": "gemma4:26b",    "messages": [      {        "role": "user",        "content": "请返回一句简短的接入成功提示。"      }    ],    "max_tokens": 64,    "stream": false  }'

如果 curl 能成功返回，但 WorkBuddy 不能调用，优先检查 WorkBuddy 填写的是完整接口地址，而不是只填 https://a.skypool.xyz/v1。

排查清单

现象处理方式
模型不出现在列表里检查 availableModels 是否包含对应 id，保存后重启 WorkBuddy
认证失败检查环境变量是否被 WorkBuddy 进程读取，或临时直接填写 Key 验证
404检查模型 ID 是否来自天池 Token 模型列表
请求地址错误WorkBuddy 的 url 通常需要完整 /v1/chat/completions 地址
工具调用异常先确认模型是否适合工具调用，再检查 supportsToolCall 设置

参考资料