云筑Hub 标志 云筑HubAPI 接入指南 模型广场
自定义供应商

Workbuddy 接入

在 Workbuddy 的自定义供应商中填写云筑Hub 接口地址、API Key 和模型 ID。

预计 8–12 分钟含完整公共前置流程截图可点击放大
固定接口地址https://www.yunzhuhub.com/v1注意末尾必须包含 /v1
01

填写新版注册信息

打开「创建一个账户」注册页，依次填写用户名、密码、确认密码和电子邮件。已有账号可直接登录，无需重复注册。

打开新版注册页
依次填写用户名、密码、确认密码和邮箱（截图已做隐私处理）
02

验证邮箱并完成注册

按页面提示完成人机验证；点击「发送验证码」，填写邮箱收到的验证码，勾选用户协议及隐私政策，再点击「创建账户」。注册成功后使用用户名或邮箱登录。人机验证的形式和显示位置以当前页面为准。

进入控制台
完成页面要求的人机验证，填写邮箱验证码并勾选协议（截图已做隐私处理）
03

从控制台进入钱包

登录后，在控制台侧边栏进入「个人 → 钱包」。若侧边栏未展开，先点击左上角菜单按钮，再选择「钱包」；手机端同样操作。

打开钱包
从「个人」分组进入「钱包」（截图已做隐私处理）
04

兑换或充值额度

打开钱包，向下找到「有兑换码吗？」区域，输入兑换码并点击「兑换额度」。如需在线充值，按页面当前提供的金额、付款方式和提示操作。

在钱包找到「有兑换码吗？」并点击「兑换额度」（截图已做隐私处理）
05

进入 API 密钥管理

在控制台侧边栏进入「常规 → API 密钥」。新版支持「卡片视图」和「表格视图」，右上角可切换显示方式；两种视图管理的是同一组密钥。

打开 API 密钥
从「常规」分组进入「API 密钥」（截图已做隐私处理）
06

创建并设置 API 密钥

点击「创建 API 密钥」，在右侧抽屉只填写便于识别的用途/令牌名称，例如 Workbuddy、Codex、Claude Code 或具体项目名，然后点击「保存更改」。

点击「创建 API 密钥」（截图已做隐私处理）
只填写用途/令牌名称，其他选项不要填写（截图已做隐私处理）
07

复制并妥善保存 API Key

保存后，在卡片视图点击密钥右侧的复制图标；在表格视图点击「API 密钥」列旁的复制图标。首次点击若提示密钥正在加载，等待完成后再点击一次即可，不要重复创建。点击 sk-*** 文本也可查看完整密钥。

API Key 示例
<YOUR_API_KEY>
卡片视图中点击密钥右侧的复制图标（截图已做隐私处理）
表格视图中从「API 密钥」列复制（截图已做隐私处理）
08

在模型广场取得准确模型 ID

打开模型广场，在搜索框输入需要的模型名称，向下查看匹配的模型卡片。点击卡片中的「复制模型名称」图标，取得准确模型 ID。截图中的模型仅为操作示例，实际模型列表、价格和限制以官网实时页面为准。

查看模型广场
搜索并确认需要使用的模型（截图已做隐私处理）
通过模型卡片名称或复制按钮取得准确模型 ID（截图已做隐私处理）
09

打开 Workbuddy 设置

启动 Workbuddy，进入设置页面。个人资料等信息不影响模型配置。

Workbuddy 设置入口（示意截图已做隐私处理）
10

进入模型设置

在设置中选择「模型」，进入模型与供应商管理。

Workbuddy 模型设置（示意截图已做隐私处理）
11

添加模型

点击添加模型或新增供应商，准备创建自定义配置。

Workbuddy 添加模型（示意截图已做隐私处理）
12

供应商选择自定义

供应商类型选择「自定义」。不要选择带固定官方域名的预设供应商。

Workbuddy 自定义供应商（示意截图已做隐私处理）
13

填写地址、Key 与模型 ID

API 地址填写 https://www.yunzhuhub.com/v1，API Key 粘贴你的 API 密钥，模型 ID 从模型广场复制。保存后选择新增模型并发送 hi。

填写 Workbuddy 自定义模型字段（示意截图已做隐私处理）

故障排查

没有成功时按顺序检查

1主地址先用 https://www.yunzhuhub.com/v1。
2若版本明确要求完整端点，再用 /v1/chat/completions。
3保存后要在对话模型选择器中切换到新模型。
4检查 Key、模型 ID 和余额；不要把 Key 发给客服。

完成配置

发送 hi 做首次测试

能收到正常回复就表示接入完成。若失败，先检查地址、Key、模型 ID 与余额，再把报错截图发给客服。

返回首页模型广场