01
填写新版注册信息
打开标题为「创建一个账户」的新版注册页，依次填写用户名、密码、确认密码和电子邮件。已有账号可直接登录，无需重复注册。
打开新版注册页OpenAI 兼容
开发者接入
通过 OpenAI 兼容格式接入云筑Hub，包含完整请求示例和常见错误排查。
固定接口地址
https://www.yunzhuhub.com/v1注意末尾必须包含 /v102
03
04
兑换或充值额度
在钱包页找到「添加资金」中的「有兑换码吗？」区域，输入兑换码并点击「兑换额度」；也可以按页面当前提供的方式充值。
05
06
创建并设置 API 密钥
点击「创建 API 密钥」，在右侧抽屉只填写便于识别的用途/令牌名称，例如 Workbuddy、Codex 或具体项目名，然后点击「保存更改」。
07
复制并妥善保存 API Key
保存后，从 API Key 列复制密钥；点击 sk-*** 文本也可以打开「完整 API 密钥」弹层。手机端首次点击复制可能只触发加载，等待加载提示完成后再点击一次复制，不要重复创建。
API Key 示例
<YOUR_API_KEY>08
在模型广场取得准确模型 ID
打开模型广场并搜索需要的模型，通过模型卡片名称或复制按钮取得完整模型 ID。模型列表与价格会更新，以官网实时页面为准。
查看模型广场09
使用 OpenAI 兼容格式
云筑Hub 提供 OpenAI 兼容接口。通用请求头如下，业务请求使用 Authorization: Bearer 传递 Key。
HTTP Headers
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json10
用 Curl 发起最小请求
将 <MODEL_ID> 替换为模型广场中的真实模型 ID。
Shell
curl https://www.yunzhuhub.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-d '{
"model": "<MODEL_ID>",
"messages": [{"role": "user", "content": "hi"}]
}'11
用 Python OpenAI SDK 接入
安装并使用官方 OpenAI Python SDK，把 base_url 指向云筑Hub。
Shell
pip install openaiPython
from openai import OpenAI
client = OpenAI(
api_key="<YOUR_API_KEY>",
base_url="https://www.yunzhuhub.com/v1",
)
response = client.chat.completions.create(
model="<MODEL_ID>",
messages=[{"role": "user", "content": "hi"}],
)
print(response.choices[0].message.content)12
处理响应并记录请求信息
生产代码中应设置超时、有限重试和错误日志。日志只记录状态码、模型和请求 ID，不记录完整 Key 或敏感业务内容。
故障排查
没有成功时按顺序检查
401认证失败检查 Bearer 前缀、Key 是否完整、是否已禁用。
403权限不足检查 API 密钥权限、模型范围或账号状态。
model not found模型不存在从模型广场重新复制模型 ID，不要使用展示名。
insufficient quota额度不足进入钱包充值或兑换，并核对 API 密钥额度限制。
