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

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

复制并妥善保存 API Key

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

API Key 示例
<YOUR_API_KEY>
卡片视图中点击密钥右侧的复制图标（截图已做隐私处理）
表格视图中从「API 密钥」列复制（截图已做隐私处理）
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 与余额，再把报错截图发给客服。

返回首页模型广场