云智 Token Hub · 文档

快速开始

10 分钟接入 更新于 2026-09-13全部代码示例已实测

本教程带你从零开始接入云智 Token Hub：注册控制台、创建一枚 API Key，并用 cURL 发出第一个真实请求。全程不需要安装任何 SDK。

前置条件

  • 可以访问 https://maas.piteyun.com 的浏览器或终端
  • 注册控制台账号并完成实名认证，即可获得体验额度
  • 本页示例使用 cURL（macOS / Linux / Windows 10+ 自带）

第一步：创建 API Key

  1. 登录控制台，进入 API 密钥管理 页面。
  2. 点击 创建 API Key，填写名称（建议标注用途），有效期建议选择 90 天。
  3. 回到密钥列表，确认状态为有效，点击目标行的复制 API 密钥。列表中的 sk-••••...•••• 是遮罩文本，不能使用。
密钥安全 不要把完整密钥粘贴到代码仓库、截图或聊天记录中。密钥泄露后请立即删除并重建。详见密钥管理与安全。

第二步：发起首次请求

把 $YUNZHI_API_KEY 替换为你复制的完整密钥：

bash · curl 
curl https://maas.piteyun.com/v1/chat/completions \
  -H "Authorization: Bearer $YUNZHI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3-flash",
    "messages": [
      {"role": "user", "content": "只回复：配置成功"}
    ]
  }'

第三步：核对响应

一次成功的调用返回 HTTP 200。注意云智网关对非流式响应做了包裹，正文在 data 字段内：

response · json 
{
  "code": 0,
  "message": "success",
  "data": {
    "model": "glm-5.3-flash",
    "choices": [{ "message": { "content": "配置成功" } }],
    "usage": { "total_tokens": 113 }
  }
}
两种读法 流式请求（"stream": true）返回标准 OpenAI SSE 格式，没有包裹层；用 OpenAI SDK 或编码工具时优先走流式。非流式请从 body.data.choices 取值。详见 API 端点总览。

下一步