Vidu 图生视频

使用一张图片作为视频起始画面，根据图片和提示词生成视频。

图片必须是公网可以访问的 URL，或者符合接口要求的 Base64 图片。

接口信息

方法	POST
路径	/ent/v2/img2video
完整地址	https://api000.com/ent/v2/img2video

---

请求头

参数	必填	示例
Content-Type	是	application/json
Authorization	是	Bearer sk-xxxxxxxxxxxxxxxx

---

请求示例

{
  "model": "viduq3-pro",
  "images": [
    "https://example.com/product.png"
  ],
  "prompt": "保持参考图中的产品外观和结构不变，镜头缓慢向产品推进，柔和轮廓光扫过产品边缘，展示材质和细节，最后拉回完整产品画面并稳定定格。不要生成文字、字幕、水印或多余产品。",
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "9:16",
  "seed": 12345,
  "movement_amplitude": "auto",
  "audio": true,
  "off_peak": false,
  "watermark": false
}

cURL 示例

curl https://api000.com/ent/v2/img2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "viduq3-pro",
    "images": [
      "https://example.com/product.png"
    ],
    "prompt": "镜头缓慢推进，展示产品外观和材质细节，主体保持稳定。",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16",
    "audio": true,
    "off_peak": false,
    "watermark": false
  }'

---

图片要求

项目	要求
图片数量	只传入一张图片
图片来源	公网 URL 或 Base64
支持格式	PNG、JPEG、JPG、WebP
单张大小	不超过 50MB
图片比例	不要超过 1:4 或 4:1
请求 Body	使用 Base64 时，整个请求 Body 不应超过 20MB

---

Body 参数

参数	类型	必填	说明
model	string	是	模型名称，例如 viduq3-pro、viduq2-pro
images	string[]	是	一张图片的公网 URL 或 Base64
prompt	string	否	视频提示词，最长不超过 5000 个字符
duration	integer	否	Q3 通常支持 1–16 秒，Q2 通常支持 1–10 秒
resolution	string	否	清晰度，例如 720p、1080p
aspect_ratio	string	否	输出画面比例，建议与原图比例保持一致
seed	integer	否	随机种子
movement_amplitude	string	否	运动幅度，例如 auto、small、medium、large
audio	boolean	否	是否生成声音；Q3 模型默认支持原生音视频
audio_type	string	否	声音类型，例如 all、speech_only、sound-effect_only
bgm	boolean	否	是否生成背景音乐；Q3 模型不支持该参数
off_peak	boolean	否	是否使用错峰生成
watermark	boolean	否	是否添加水印
payload	string	否	自定义业务追踪字段
client_request_id	string	否	客户端请求唯一标识
callback_url	string	否	任务状态回调地址

图片必须能够被服务器直接访问。网页内临时地址、需要登录的图片地址或本地文件路径无法使用。

---

成功响应

{
  "task_id": "911084878697623552",
  "state": "created",
  "model": "viduq3-pro",
  "images": [
    "https://example.com/product.png"
  ],
  "prompt": "镜头缓慢推进，展示产品外观和材质细节",
  "duration": 10,
  "resolution": "1080p",
  "audio": true,
  "off_peak": false,
  "created_at": "2026-01-20T06:37:57Z"
}

拿到 task_id 后，调用 Vidu 查询结果 获取最终视频 URL。