快速开始

用最少步骤完成第一次调用。产品名称：清霄 API（专业 LLM 聚合平台）。

1. 获取 API Key

打开清霄控制台并登录。
创建用户令牌（常见形态为 sk-…）。
妥善保存；关闭弹窗后可能无法再次查看完整明文。

密钥仅在服务端使用；勿写入仓库或前端包体。可用模型与价格以控制台为准。

2. Base URL

text

https://api.qingxiaocloud.com

若 SDK 要求「带 /v1 的 base」，使用：

text

https://api.qingxiaocloud.com/v1

3. 鉴权头

http

Authorization: Bearer sk-YOUR_KEY
Content-Type: application/json

Anthropic Messages 另需 anthropic-version，也可用 x-api-key。详见鉴权。

4. Chat Completions（curl）

model 请填控制台当前可用的文本模型 id。

bash

export QX_API_KEY='sk-YOUR_KEY'
export QX_BASE='https://api.qingxiaocloud.com'

curl -sS "$QX_BASE/v1/chat/completions" \
  -H "Authorization: Bearer $QX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "用一句话介绍清霄 API"}
    ]
  }'

5. Chat Completions（JavaScript）

const base = 'https://api.qingxiaocloud.com'
const apiKey = process.env.QX_API_KEY // 切勿硬编码

const res = await fetch(`${base}/v1/chat/completions`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'YOUR_MODEL_ID',
    messages: [{ role: 'user', content: '用一句话介绍清霄 API' }],
  }),
})

if (!res.ok) {
  throw new Error(`HTTP ${res.status}: ${await res.text()}`)
}

const data = await res.json()
console.log(data.choices?.[0]?.message?.content)

6. 视频生成（minimax-h3）

公开 model：minimax-h3-480p、minimax-h3-768p。

推荐顺序：鉴权 →（可选）上传 /v1/files → 出片 /v1/videos → 轮询 → 下载。
出片接口只收 HTTPS URL；本地文件请先上传。完整说明见视频 minimax-h3。

文生示例

bash

curl -sS -X POST "$QX_BASE/v1/videos" \
  -H "Authorization: Bearer $QX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "雨中散步的猫",
    "model": "minimax-h3-768p",
    "seconds": 5
  }'

成功响应含任务 id（video_…）与 status。每隔几秒调用 GET /v1/videos/{id}，completed 后下载 GET /v1/videos/{id}/content。

图生要点

POST /v1/files，字段名 file，带上同一 sk-。
取出返回的 url。
POST /v1/videos JSON："input_reference": "<url>"。

上传 API 合入后生效；在此之前可用你已有的公网 https 图链。

快速开始 ​

1. 获取 API Key ​

2. Base URL ​

3. 鉴权头 ​

4. Chat Completions（curl） ​

5. Chat Completions（JavaScript） ​

6. 视频生成（minimax-h3） ​

文生示例 ​

图生要点 ​

下一步 ​