跳转到主要内容
首帧

Vidu — 创建任务

提交一个基于首帧图像的 Vidu 图生视频任务。

POST
/services/aigc/video-generation/video-synthesis
cURL
curl --location 'https://dashscope.aliyuncs.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_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
    }
}'
{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}
使用图像作为首帧生成视频。任务异步执行,提交后请调用查询视频结果接口获取任务状态和视频 URL。

模型

模型最高分辨率最长时长
vidu/viduq3-pro_img2video1080P16 秒
vidu/viduq3-turbo_img2video1080P16 秒
vidu/viduq2-pro_img2video1080P10 秒
vidu/viduq2-turbo_img2video1080P10 秒

图像要求

  • 格式:JPG、PNG 或 WEBP
  • 宽高比:1:4 到 4:1 之间
  • 文件大小:最大 50 MB

轮询

提交任务后,每隔 15 秒轮询查询视频结果接口,直到 task_status 变为 SUCCEEDEDFAILED。生成的视频 URL 自任务完成起 24 小时内有效,请及时下载。

鉴权

string
header
必填

千问云 API Key。详见获取 API Key

Header 参数

enum<string>
必填

必须设置为 enable。此 API 仅支持异步处理。

enable

请求体

application/json
enum<string>
必填

模型名称。

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

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

图生视频的输入数据。

object

视频生成参数。

响应

200-application/json
string

用于追踪和排查问题的唯一请求标识符。

4909100c-7b5a-9f92-bfe5-xxxxxx
object