云筑Hub 标志 云筑HubAPI 接入指南 模型广场
零代码配置

通用手动接入

面向非开发用户，适用于支持自定义 API 地址、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

找到软件里的自定义 API 配置

不同软件的字段名称可能不同，但通常指向同一项：

API 地址API BaseBase URLEndpointOpenAI Base URL
10

填写 API Key 和模型 ID

认证方式选择 API Key 或 Bearer Token。粘贴刚创建的 Key，再从模型广场复制模型 ID。不要凭印象手输模型名称。

11

保存并发送测试消息

保存配置，选择刚添加的模型，新建对话发送 hi。收到回复即完成。

故障排查

没有成功时按顺序检查

1地址必须是 https://www.yunzhuhub.com/v1，检查协议、域名和 /v1。
2Key不要带空格或引号；失效后在 API 密钥管理中重建。
3模型 ID以模型广场为准，区分连字符、数字和大小写。
4余额确认额度充足，并检查 API 密钥是否限制了可用模型。
5客户端能力确认软件支持自定义 OpenAI 兼容 API。

完成配置

发送 hi 做首次测试

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

返回首页模型广场