功能介绍

将一张图片作为视频起始画面，结合文字描述控制运动。统一视频入口检测 input_reference / image 等首图信息，转为可灵原生 image2video。

鉴权与操作步骤

所有请求发送到 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、input_reference，建议填 prompt。默认5秒；v1/v1-6可用std/pro，v2-master仅pro。图生主要跟随首图比例，size并非任意像素输出承诺。

图片应为 JPG/JPEG/PNG，≤10 MB，宽高均≥300 px，宽高比0.4–2.5。使用 JSON 时提供 HTTPS 直链或裸 Base64，不要加 data:image/png;base64, 前缀。尾帧等可选字段见参数说明。

运行示例前

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": "人物轻轻转头看向远方，镜头保持平稳。",
  "input_reference": "https://example.com/first-frame.png",
  "seconds": 5,
  "mode": "std"
}'

本地首图上传

准备同目录的 first-frame.png。只有一个文件字段 input_reference，无需手动编码 Base64。表单Content-Type由客户端自动带boundary；不要手动填写。表单若需 metadata，传 JSON 字符串。

curl --fail-with-body "https://top.qingyuntop.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F 'model=kling-v1-6' \
  -F 'prompt=主体自然运动，保持外观一致。' \
  -F 'seconds=5' \
  -F 'mode=std' \
  -F "input_reference=@first-frame.png"

返回结果与下一步

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