云枢 API logo云枢 API
OpenAI 兼容接口

云枢 API 接入文档

云枢 API 统一转发 CPA 当前可用模型。模型名称保留原始名称,按量档位计费,可直接用于支持 OpenAI Base URL 的客户端。

快速信息

Base URLhttps://api.wentai.art/v1
鉴权方式Bearer API Key
令牌管理/console/token
计费符号🐾

1. 创建 API Key

登录控制台后进入 令牌管理,新建令牌并保存生成的 sk-...。请求时在 Header 中传入:

Authorization: Bearer sk-your-api-key

API Key 等同账户调用权限,不要暴露在前端页面、公开仓库、截图或聊天记录中。

2. Chat Completions

适用于绝大多数 OpenAI 兼容客户端和 SDK。

curl https://api.wentai.art/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {"role": "user", "content": "用一句话介绍云枢 API"}
    ]
  }'

3. Responses

兼容使用 Responses API 的工具链。

curl https://api.wentai.art/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "写一个 3 条要点的接口接入说明"
  }'

4. 当前模型

对外展示 CPA 当前实际可用模型,名称使用原始模型名。

也可以通过接口查询:

curl https://api.wentai.art/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

5. 客户端配置

Cherry Studio / LobeChat / 兼容客户端

服务商选择 OpenAI Compatible,Base URL 填 https://api.wentai.art/v1,API Key 填控制台令牌。

常见路径

/v1/chat/completions/v1/responses/v1/models 已开放;其他能力取决于 CPA 上游模型支持。

6. 计费与余额

控制台使用 🐾 作为余额和价格展示符号。模型广场展示每个模型的当前按量档位,实际扣费以请求模型、输入输出规模和系统记录为准。