Vidu 图生视频 viduq3-pro-fast
使用 Vidu 模型将图片转换为视频。提交任务后,请通过 GET /vidu/ent/v2/tasks/{task_id}/creations 查询状态。 使用模型 viduq3-pro-fast。
授权
在请求头中传入 Authorization: Bearer <token>。
请求体
视频生成模型名称。
- viduq3-pro-fast: 高效生成高质量音视频内容,生成速度更快,性价比高
viduq3-pro-fast 用作生成视频起始帧的图片。
- 仅接受 1 张图片
- 支持公网 URL 或 Base64 格式
- 支持格式:png, jpeg, jpg, webp
- 图片宽高比必须在 1:4 到 4:1 之间
- 单张图片限制 50MB
- HTTP 请求体不超过 20MB
- Base64 格式示例:
data:image/png;base64,{base64_encode}
1 element文本提示词,用于描述视频生成内容。 注意:如果使用了推荐提示词(is_rec=true),模型将忽略手动输入的 prompt 参数。
5000是否使用推荐提示词。
- true: 是,系统自动生成并应用推荐提示词,推荐提示词数量 = 1
- false: 否,根据用户提供的提示词生成视频 注意:启用推荐提示词功能时,每个任务将额外消耗 10 积分。
是否使用直出音视频能力。
- false: 不进行直出音视频,输出无声视频
- true: 需要直出音视频,输出有声视频(包含对话和音效) 注意 1:voice_id 参数仅在 audio=true 时生效 注意 2:当此参数为 true 时,不支持交错模式(q3 模型支持交错模式) 注意 3:当 model 为 q3 时,此参数默认值为 true
音频类型,当 audio=true 时必填。
- all: 音效+人声
- speech_only: 仅人声
- sound-effect_only: 仅音效 注意:目前该参数仅支持 q2、q1 和 2.0 系列模型的音频分离。
all, speech_only, sound-effect_only 视频时长(秒)。不同模型的默认值和可用范围:
- viduq3-pro-fast, viduq3-pro, viduq3-turbo: 默认 5,可用 1-16
1 <= x <= 16随机种子。
- 默认为随机种子数
- 手动设置值将覆盖默认随机种子
分辨率(基于模型和时长)。
- viduq3-pro-fast (1-16s): 默认 720p,可选 720p, 1080p
- viduq3-pro, viduq3-turbo (1-16s): 默认 720p,可选 540p, 720p, 1080p
720p, 1080p 透传参数。 不做处理,仅做数据透传,最大长度 1048576 字符。
1048576错峰模式,默认为:false,可选值:
- true:错峰生成视频;
- false:即时生成视频;
注1:错峰模式消耗的积分更低,具体请查看产品定价
注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分;
注3:您也可以手动取消错峰任务
注4:除q3 外的其他音视频直出功能,都不支持错峰模式
是否添加水印
- true:添加水印;
- false:不添加水印;
注1:目前水印内容为固定,内容由AI生成,默认不加
注2:您可以通过watermarked_url参数查询获取带水印的视频内容,详情见查询任务接口
水印位置,表示水印出现在图片的位置,可选项为:
- 1: 左上角
- 2: 右上角
- 3: 右下角
- 4: 左下角
默认为:3
1, 2, 3, 4 1 <= x <= 4水印内容,此处为图片URL。不传时,使用默认水印:内容由AI生成
元数据标识,json格式字符串,透传字段,您可以自定义格式或使用示例格式,示例如下:
该参数为空时,默认使用vidu生成的元数据标识
Callback 协议。需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务有状态变化时,Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致。
回调返回的 "status" 包括以下状态:
- processing: 任务处理中
- success: 任务完成(如发送失败,回调三次)
- failed: 任务失败(如发送失败,回调三次)
响应
提交成功,返回视频任务对象。
任务 ID。
任务处理状态:
- created: 任务创建成功
- queueing: 任务排队中
- processing: 任务处理中
- success: 生成成功
- failed: 任务失败
created, queueing, processing, success, failed 本次调用使用的模型参数。
本次调用使用的文本提示词。
本次调用使用的图片列表。
本次调用使用的视频时长参数。
本次调用是否使用音频。
本次调用使用的音频类型参数。
本次调用使用的随机种子参数。
本次调用使用的分辨率参数。
本次调用使用的透传参数。
本次调用使用的错峰模式参数。
本次调用消耗的积分。
本次提交任务是否使用水印。
任务创建时间。