创建统一格式视频任务

接口和请求头

POST https://top.qingyuntop.ai/v1/videos

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

按下表填写模型与输入即可提交对应视频任务。使用青云TOP API Key，无需填写阿里百炼 Key、地域 Endpoint 或 X-DashScope-Async 请求头。

请求参数

模型限制

表内输入字段可放在 metadata.input；生成参数可放在 metadata.parameters。扩展对象的同名字段会覆盖顶层字段，应只选一处填写。数字人时长跟随音频，省略 seconds；其他模型默认 5 秒。旧版文生模型使用 resolution + ratio 确定输出尺寸，无需另填原生 size。

媒体组合、原生参数含义见原生创建说明。Wan 3.0 智能时长可在本接口设置 seconds: -1；输入视频加输出视频不能超过 30 秒。普通图生比例由图片决定，ratio 会被移除。

文生视频示例

下面示例使用 wan2.7-t2v，返回的 id 是统一接口的公共任务 ID。

cURL 使用 Bash 语法；Python 安装 requests 后运行；Node.js 使用 22+ 并保存为 .mjs。示例中的 Key、任务 ID 和 example.com 素材地址都是占位符。

curl --fail-with-body "https://top.qingyuntop.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan2.7-t2v","prompt":"雨后的老街，镜头缓慢向前推进，电影感光影。","seconds":5,"resolution":"720P","ratio":"16:9","prompt_extend":true,"watermark":false}'

Wan 3.0 参考生视频示例

Wan 3.0 的专用媒体数组放在 metadata.input.media，每项必须有 type 和 url。file 与 link 不能同时使用；使用文件或网页时必须把 prompt_extend 设为 true。

首尾帧不能与 reference_*、file、link 混用；尾帧必须配首帧。参考图最多 10 张，参考视频和参考音频各最多 5 个、每类总时长不超过 15 秒。将下面完整请求体替换文生示例的 body / json 即可。

{
  "model": "wan3.0-video",
  "prompt": "图1中的人物沿着视频1的运动方向奔跑，保持服装和光线一致。",
  "seconds": 8,
  "resolution": "1080P",
  "ratio": "16:9",
  "metadata": {
    "input": {
      "media": [
        {"type": "reference_image", "url": "https://example.com/character.png"},
        {"type": "reference_video", "url": "https://example.com/motion.mp4"}
      ]
    }
  }
}

输入地址要求

本入口不接受 multipart 文件上传。素材使用无需登录即可访问的 HTTPS 文件 URL；图片也可以使用完整图片 data URL。视频和音频按官方模型要求提供文件 URL，不要把所有媒体都当作图片 Base64。过期签名 URL、需要 Cookie 的页面和本地路径会导致素材读取失败。

图生视频请求体

Wan 2.7 首尾帧使用 media，下面完整请求体仍发到 /v1/videos。首帧加可选尾帧与配音的组合、first_clip 视频续写、旧版 img_url 和数字人用法详见按场景输入说明；在统一格式中把其中的 input 放到 metadata.input，parameters 放到 metadata.parameters 即可。

{
  "model": "wan2.7-i2v",
  "prompt": "人物自然转身，镜头保持稳定。",
  "seconds": 5,
  "resolution": "720P",
  "metadata": {
    "input": {"media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ]}
  }
}

创建后返回 video 对象，保存 id。status 为 queued / in_progress 时等待，completed 时下载；返回 400 时先核对模型参数。完整响应状态及轮询示例见查询和下载。