快速开始

完成下面四步，即可发出第一个云枢 API 请求。

1. 注册并登录

打开云枢主站，注册账号并登录控制台。如果已有账号，可直接进入访问令牌页面。

2. 创建访问令牌

点击“添加令牌”，填写一个能识别用途的名称，例如 MacBook-Codex 或 Cherry-Studio。创建后复制以 sk- 开头的令牌。

令牌等同于账号密码。不要把真实令牌粘贴到文档、截图、工单或公开仓库中。

更详细的权限、额度和安全设置请查看创建访问令牌。

3. 选择模型

打开模型广场，复制需要使用的模型 ID。客户端和 API 请求中的 model 必须与模型 ID 完全一致。

也可以通过 API 查询当前令牌可访问的模型：

curl https://yunshuapi.org/v1/models \
  -H "Authorization: Bearer sk-your-token"

4. 发出测试请求

将下面的 sk-your-token 和 your-model-id 替换为自己的令牌和模型 ID：

curl https://yunshuapi.org/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      { "role": "user", "content": "请用一句话介绍你自己" }
    ]
  }'

Windows PowerShell 中建议使用 curl.exe 执行该示例，避免 curl 别名造成参数解析差异。

下一步

• 命令行开发：查看 Claude Code 或 Codex
• 桌面聊天：查看 Cherry Studio 或 Chatbox
• 自己开发程序：查看调用 API