在 WorkBuddy 中使用平台模型
通过自定义 API 配置，将雄安国际TOKEN服务平台模型添加到 WorkBuddy。
接入准备
- 1开通模型服务在平台完成模型订购。
前往模型广场 ↗ - 2获取 API Key在平台「API Key 管理」中创建
或复制有模型调用权限的密钥。 - 3确认调用模型名从模型详情页调用示例中复制
model字段，保留服务商前缀。
平台接入参数
| 参数 | 填写内容 |
|---|---|
| 接口协议 | OpenAI Chat Completions |
| 完整请求地址 | http://xatokenhub.com:30080/v1/chat/completions |
| Base URL | http://xatokenhub.com:30080/v1 |
| API Key | 在雄安国际TOKEN服务平台获取的 API Key请妥善保管 |
| 模型名称 / ID | ZHENZE/GLM-5.2示例 |
模型以你已开通服务的调用示例为准，请勿填写模型卡片上的 mod-… 资源编号。各工具的地址填写方式见下方配置。
配置步骤
验证接入
选择刚添加的模型，发送「你好，请简单介绍一下自己」。需要排查接口时，可在本机终端运行以下请求。
curl 'http://xatokenhub.com:30080/v1/chat/completions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{
"model": "ZHENZE/GLM-5.2",
"messages": [{"role": "user", "content": "你好，请简单介绍一下自己"}],
"stream": false
}'将 YOUR_API_KEY 替换为自己的密钥，并替换为有权限调用的模型名。Windows PowerShell 请使用 curl.exe 并调整续行语法。
choices[0].message.content 中有模型回复。智能体还需单独验证工具调用能力。当前地址使用 HTTP，密钥与请求内容未经 TLS 加密，请在平台认可的网络环境中使用。
常见问题
Base URL 和完整请求地址应该填哪个？
WorkBuddy 本教程开启「自定义协议」、TRAE 和 CC Switch 开启「完整 URL」，均填写完整地址 http://xatokenhub.com:30080/v1/chat/completions。DeepSeek Harness 的 Base URL 填 http://xatokenhub.com:30080/v1，由客户端补全路径。两种字段不要混填，最终请求地址只能有一个 /v1/chat/completions。
返回 401 / 403，或提示没有模型权限？
检查 API Key 是否完整、有效，调用模型是否已订购，以及密钥所属账号是否有对应权限。确认鉴权格式为 Authorization: Bearer YOUR_API_KEY；向平台排查时仅提供脱敏错误信息，不要发送完整密钥。
返回 404 / 405，或提示模型不存在？
先核对地址、端口与协议。平台不提供 Anthropic Messages 或 OpenAI Responses 接口。模型名请复制平台调用示例中的 model 值，保留大小写与前缀；例如 ZHENZE/GLM-5.2，不要使用 mod-…。
能正常聊天，为什么智能体执行任务失败？
聊天连通不代表模型支持所有智能体能力。请核实所选模型和平台链路对 tools、tool_calls、流式输出及上下文长度的支持。先测试简单聊天，再测试一个简单工具任务；仅为具备相应能力的模型启用图片输入或工具调用。
Claude Code 可以直接使用平台地址吗？
不能仅替换 Claude Code 的 Anthropic 地址。请按照 CC Switch 教程将上游格式设为 OpenAI Chat Completions，并启动本地路由、为 Claude Code 启用路由。使用时保持 CC Switch 路由服务运行。
为什么自动获取模型列表失败？
本指南仅以平台已明确提供的 Chat Completions 接口为依据，不能假定平台支持 /v1/models。请从模型详情页手动复制调用模型名；模型列表获取失败不等于聊天接口不可用。
返回 429、请求超时，或浏览器无法调用？
429 通常需要检查配额、并发和请求频率。超时请确认客户端所在网络可访问 xatokenhub.com:30080。HTTPS 网页直接请求 HTTP 接口可能被浏览器拦截，也可能遇到 CORS 限制；请先使用桌面客户端或本机终端验证。本帮助页不发送模型请求。