功能介绍

将文字描述转换成短视频，不需要上传素材。示例使用 kling-v1-6、std、5秒、16:9。

鉴权与操作步骤

所有请求发送到 https://top.qingyuntop.ai。在请求头填写 Authorization: Bearer YOUR_API_KEY，将 YOUR_API_KEY 替换为青云TOP API 控制台创建的 API Key；Bearer 与密钥之间保留一个空格。

  1. 携带鉴权请求头，按本页参数创建任务。
  2. 保存返回的任务标识，查询至成功后下载视频。创建成功仅表示任务已受理。

JSON 请求使用 Content-Type: application/json。示例中的占位密钥需替换为你的 API Key。实际业务请在服务端保存密钥，不要放进公开网页。

创建接口与参数

POST /v1/videos，必填 model、prompt。seconds 默认5，mode 默认由模型决定，文生比例可用 metadata.aspect_ratio。选择 kling-v2-master 时改为 pro。全部含义与覆盖规则见统一视频参数。

运行示例前

cURL 示例使用 Bash 换行语法；Python 需要安装 requests；Node.js 使用 20 或更高版本，将代码保存为 .mjs。带素材的示例必须把 https://example.com/... 替换为上游能直接读取的真实 HTTPS 文件地址，不是网页地址或本机文件路径。

代码示例

curl --fail-with-body "https://top.qingyuntop.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-v1-6",
  "prompt": "清晨山谷薄雾散开，镜头缓慢向前推进，电影感自然光。",
  "seconds": 5,
  "mode": "std",
  "metadata": {
    "aspect_ratio": "16:9"
  }
}'

返回结果与下一步

保存返回的 id，按统一视频查询与下载查询 status。只有 completed 才表示视频已完成；model 在本接口的统一响应中可能为空。