Vidu Q4 Preview 图生视频 API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型 | vidu-q4-preview/image-to-video |
|---|---|
| 能力 | 首帧图生视频 + 原生音频 |
| 分辨率 | 540p / 720p / 1080p / 2K / 4K |
| 时长 | 3-16 秒 |
上传 1 张首帧图，生成 3-16 秒、最高 4K 的视频，可同步生成对白和音效；画幅跟随首帧图片。
生产建议
调用建议
- 想竖屏输出就传竖屏首帧图；画幅完全跟随图片，无需额外参数。
- audio=false 生成无声视频，适合纯画面镜头。
- 使用 callback.url 接收任务完成或失败通知；查询响应从 data 读取任务对象，回调正文直接读取任务对象。
- 产物 URL 有有效期，需要长期保存时请转存到自己的存储。
适用场景
图片动画化
让产品图、海报、风景或角色立绘产生自然动作。
image_url有声短片
为画面生成同步对白和音效，适合口播和广告。
audio高分辨率输出
最高 4K，适合投放与大屏展示。
resolution请求参数
model string 必填 模型 ID。
input object 必填 首帧图生视频参数。
image_url string 必填 首帧图片 HTTP(S) URL。JPG/JPEG/PNG/WEBP，单张不超过 50MB；输出画幅跟随这张图片，宽高比需在 1:4 到 4:1 之间。
prompt string 可选 描述画面中加入的动作、镜头和声音（对白、音效），不必重复画面内容。最多 20,000 字符。
duration integer 可选 输出时长，3-16 秒的整数。
resolution enum 可选 输出分辨率。
audio boolean 可选 是否生成与画面同步的对白和音效（原生音频）。
callback object 可选 任务完成或失败后发送通知；查询响应从 data 读取任务对象，回调正文直接读取任务对象。
url string 必填 接收任务完成或失败通知的 HTTPS 地址。
when enum 可选 任务完成或失败时触发。
用例示例
首帧生视频
只传首帧图片和提示词，模型生成动作与镜头。
请求体
{
"model": "vidu-q4-preview/image-to-video",
"input": {
"image_url": "https://example.com/first-frame.jpg",
"prompt": "镜头缓慢推进，画面主体自然运动",
"duration": 5,
"resolution": "720p"
}
}无声视频
关闭原生音频，只生成画面。
请求体
{
"model": "vidu-q4-preview/image-to-video",
"input": {
"image_url": "https://example.com/first-frame.jpg",
"prompt": "镜头缓慢推进",
"duration": 8,
"resolution": "1080p",
"audio": false
}
}获取结果
- 创建任务响应从 data.taskId 读取任务 ID。
- 等待 callback，或调用 GET /v1/tasks/:id 查询状态；轮询响应从 data 读取任务对象。
- status=success 时，从 output 中读取 type=video 的视频 URL；callback body 直接读取 output。
常见问题
可以设置输出宽高比吗？
不需要设置。图生视频的画幅完全跟随首帧图片，想竖屏就传竖屏图。
关闭 audio 会影响价格吗？
不影响。本模型按秒计费，分辨率与时长决定价格，音频开关不参与计价。
没有 prompt 可以吗？
可以。prompt 是可选的；不传时模型根据图片内容自行生成动作。
支持哪些分辨率？
540p、720p、1080p、2k、4k 五档，默认 720p。