云筑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 或具体项目名，然后点击「保存更改」。

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

复制并妥善保存 API Key

保存后，从 API Key 列复制密钥；点击 sk-*** 文本也可以打开「完整 API 密钥」弹层。手机端首次点击复制可能只触发加载，等待加载提示完成后再点击一次复制，不要重复创建。

API Key 示例
<YOUR_API_KEY>
从 API Key 列复制新建的密钥（截图已做隐私处理）
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 与余额，再把报错截图发给客服。

返回首页模型广场