Vidu 图生视频 API 文档

根据参考图生成视频。

官方参数详见 Vidu 官方文档。

服务商支持

渠道	说明
Vidu 官方	默认

创建任务

网络协议	请求地址	请求方法	请求格式	响应格式
https	/videos/vidu/img2video	POST	application/json	application/json

请求头

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Bearer	aiping 平台鉴权

请求体参数

参数名	类型	必填	说明
model	string	是	如 viduq3-pro、viduq2-turbo、viduq3-pro-fast
images	array[string]	是	首帧参考图
prompt	string	否	提示词
duration	int	否	时长
resolution	string	否	分辨率
audio	bool	否	音视频直出
movement_amplitude	string	否	运动幅度
off_peak	bool	否	错峰
watermark	bool	否	水印
callback_url	string	否	回调地址
extra_body.provider	object	否	路由，见 路由策略

首尾帧请使用 start-end-to-video.md 中的 /videos/vidu/start-end2video。

查询任务（标准异步）

提交后使用 task-query.md 中的统一查询接口：

网络协议	请求地址	请求方法
https	/videos/vidu/tasks/{task_id}/creations	GET

响应为 Vidu 官方 creations 形态（state、creations[].url、credits 等）。

请求示例

{
  "model": "viduq3-pro-fast",
  "images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"],
  "prompt": "画面主体缓慢转身，镜头轻微推进，背景光线逐渐增强",
  "audio": false,
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "auto",
  "off_peak": false,
  "watermark": false,
  "extra_body": {
    "provider": { "only": ["Vidu"] }
  }
}

返回结构示例

{
  "task_id": "string",
  "state": "created",
  "model": "viduq3-pro-fast",
  "images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"],
  "prompt": "画面主体缓慢转身，镜头轻微推进，背景光线逐渐增强",
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "auto",
  "off_peak": false,
  "watermark": false,
  "credits": 0,
  "created_at": "2025-01-01T00:00:00Z",
  "aiping_id": "string"
}

注意事项

1. 参数取值范围、模型能力详见 Vidu 官方文档。
2. ViduQ2 错峰价格为正常生成价格的一半；如果积分存在小数，则向上取整。
3. 图生视频开启音视频直出功能时，会在对应任务基础上多消耗 15 积分。
4. 积分与人民币换算比例为：1 积分 = 0.03125 元。