跳转到主要内容
首帧

Vidu — 创建任务

基于首帧图片提交 Vidu 图生视频异步任务

POST
/services/aigc/video-generation/video-synthesis
cURL
curl --location 'https://maas.qianwenaiapi.com/api/v1/services/aigc/video-generation/video-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "vidu/viduq3-pro-fast_img2video",
    "input": {
      "media": [
        {
          "type": "image",
          "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp"
        }
      ],
      "prompt": "镜头从海龟下方缓缓上移,海龟悠然游动,腹部细节清晰可见。"
    },
    "parameters": {
      "duration": 5,
      "resolution": "720P",
      "watermark": true
    }
  }'
{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

模型概览

模型名说明
vidu/viduq3-pro-fast_img2videoq3 旗舰极速版,最高 1080P,最长 16 秒
vidu/viduq3-pro_img2videoq3 旗舰版,最高 1080P,最长 16 秒
vidu/viduq3-turbo_img2videoq3 快速版,最高 1080P,最长 16 秒
vidu/viduq2-pro-fast_img2videoq2 旗舰极速版,最高 1080P,最长 10 秒
vidu/viduq2-pro_img2videoq2 旗舰版,最高 1080P,最长 10 秒
vidu/viduq2-turbo_img2videoq2 快速版,最高 1080P,最长 10 秒

输入限制

首帧图像要求
限制项要求
格式JPG、JPEG、PNG、WEBP
宽高比1:4 到 4:1
文件大小不超过 50 MB
URL 类型HTTP/HTTPS 公网可访问地址
数量必须且仅能传入 1 张图片
提示词要求 分辨率与时长
模型支持分辨率支持时长
vidu/viduq3-pro-fast_img2video720P、1080P1–16 秒
vidu/viduq3-pro_img2video540P、720P、1080P1–16 秒
vidu/viduq3-turbo_img2video540P、720P、1080P1–16 秒
vidu/viduq2-pro-fast_img2video720P、1080P1–10 秒
vidu/viduq2-pro_img2video540P、720P、1080P1–10 秒
vidu/viduq2-turbo_img2video540P、720P、1080P1–10 秒

背景音效

parameters.audio 参数仅 q3 模型(viduq3-pro、viduq3-pro-fast、viduq3-turbo)支持。设为 true 后,模型将根据视频内容自动生成 AI 背景音效。

其他参数

参数说明
parameters.watermark是否添加水印,默认 false。水印位于视频右下角,文案固定为“内容由AI生成”。
parameters.seed随机数种子,取值 [0, 2147483647],未指定时自动生成。固定 seed 可提升可复现性,但生成具有概率性,不能保证结果完全一致。
parameters.duration、parameters.resolution直接影响费用,按秒与分辨率档位计费。

使用流程

  1. 调用本接口提交图生视频任务,获取 task_id。task_id 有效期为 24 小时,请勿重复创建任务。
  2. 调用查询结果接口,建议每 15 秒轮询一次,直到获取生成的视频 URL。

错误码

大模型服务通用状态码请查阅错误信息。
  • Python SDK
import dashscope
import os
from dashscope.v2 import DashScopeError

# 若没有配置环境变量,请用千问AI平台API Key将下行替换为:api_key="sk-xxx"
# 获取API Key:https://platform.qianwenai.com/home/api-keys
client = dashscope.Client(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://maas.qianwenaiapi.com/api/v1",
)

media = [{'type': 'image', 'url': 'https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp'}]

def sample_async_call():
    # 异步提交视频生成任务
    try:
        job = client.videos.jobs.create(
            model='vidu/viduq3-pro-fast_img2video',
            media=media,
            prompt='镜头从海龟下方缓缓上移,海龟悠然游动,腹部细节清晰可见。',
            duration=5,
            resolution='720P',
            watermark=True)
        print(job)
        print("task_id: %s" % job.task_id)
    except DashScopeError as e:
        print(f"HTTP返回码:{e.status_code}")
        print(f"错误码:{e.code}")
        print(f"错误信息:{e.message}")
        print("请参考文档:/api-reference/preparation/error-messages")
        return

    # 查询任务状态
    try:
        snapshot = client.videos.jobs.fetch(job.task_id)
        print(snapshot.status)
    except DashScopeError as e:
        print(f"HTTP返回码:{e.status_code}")
        print(f"错误码:{e.code}")
        print(f"错误信息:{e.message}")
        print("请参考文档:/api-reference/preparation/error-messages")

    # 等待任务完成(指数退避轮询,默认总预算24小时)
    try:
        done = client.videos.jobs.wait(job)
        print(done)
        print(done.video_url)
    except DashScopeError as e:
        print(f"HTTP返回码:{e.status_code}")
        print(f"错误码:{e.code}")
        print(f"错误信息:{e.message}")
        print("请参考文档:/api-reference/preparation/error-messages")

if __name__ == '__main__':
    sample_async_call()

鉴权

string
header
必填

千问AI平台 API Key。详见获取 API Key。

Header 参数

enum<string>
必填

固定值 enable,启用异步模式。

enable

请求体

application/json
enum<string>
必填

模型名称。可选值:

| 模型 | 最高分辨率 | 最长时长 | |-------|---------------|-------------| | vidu/viduq3-pro-fast_img2video | 1080P | 16 秒 | | vidu/viduq3-pro_img2video | 1080P | 16 秒 | | vidu/viduq3-turbo_img2video | 1080P | 16 秒 | | vidu/viduq2-pro-fast_img2video | 1080P | 10 秒 | | vidu/viduq2-pro_img2video | 1080P | 10 秒 | | vidu/viduq2-turbo_img2video | 1080P | 10 秒 |

vidu/viduq3-pro-fast_img2video,vidu/viduq3-pro_img2video,vidu/viduq3-turbo_img2video,vidu/viduq2-pro-fast_img2video,vidu/viduq2-pro_img2video,vidu/viduq2-turbo_img2video
object
必填
object

响应

200-application/json
string

本次请求的唯一 ID。

object