Vidu 文生视频 viduq3-pro
使用 Vidu 模型将文本提示词转换为视频。提交任务后,请通过 GET /vidu/ent/v2/tasks/{task_id}/creations 查询状态。 使用模型 viduq3-pro。
授权
在请求头中传入 Authorization: Bearer <token>。
请求体
模型名称 可选值:viduq3-pro
- viduq3-pro:高效生成优质音视频内容,让视频内容更生动、更形象、更立体,效果更好
viduq3-pro 文本提示词 生成视频的文本描述。 注:字符长度不能超过 5000 个字符
5000视频时长参数,默认值依据模型而定:
- viduq3-pro、viduq3-turbo: 默认5秒,可选:1-16
1 <= x <= 16随机种子 当默认不传或者传0时,会使用随机数替代 手动设置则使用设置的种子
比例 默认 16:9,可选值:16:9、9:16、3:4、4:3、1:1 注:3:4、4:3仅支持q2、q3系列模型
16:9, 9:16, 3:4, 4:3, 1:1 分辨率参数,默认值依据模型和视频时长而定:
- viduq3-pro、viduq3-turbo(1-16秒):默认 720p,可选:540p、720p、1080p
540p, 720p, 1080p 是否使用音视频直出能力,默认为true,枚举值为:
- false:不需要音视频直出,输出静音视频
- true:需要音画同步,输出声音的视频(包括台词和音效) 注1:仅q3系列模型支持该参数
透传参数 不做任何处理,仅数据传输 注:最多 1048576个字符
1048576错峰模式,默认为:false,可选值:
- true:错峰生成视频;
- false:即时生成视频;
注1:错峰模式消耗的积分更低,具体请查看产品定价
注2:错峰模式下提交的任务,会在48小时内生成,未能完成的任务会被自动取消,并返还该任务的积分;
注3:您也可以手动取消错峰任务
是否添加水印
- true:添加水印;
- false:不添加水印;
注1:目前水印内容为固定,内容由AI生成,默认不加
注2:您可以通过watermarked_url参数查询获取带水印的视频内容,详情见查询任务接口
水印位置,表示水印出现在图片的位置,可选项为: 1:左上角 2:右上角 3:右下角 4:左下角 默认为:3
1, 2, 3, 4 1 <= x <= 4水印内容,此处为图片URL 不传时,使用默认水印:内容由AI生成
元数据标识,json格式字符串,透传字段,您可以 自定义格式 或使用 示例格式 ,示例如下: { "Label": "your_label", "ContentProducer": "your_content_producer", "ContentPropagator": "your_content_propagator", "ProduceID": "your_product_id", "PropagateID": "your_propagate_id", "ReservedCode1": "your_reserved_code1", "ReservedCode2": "your_reserved_code2" } 该参数为空时,默认使用vidu生成的元数据标识
Callback 协议 需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务有状态变化时,Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致 回调返回的"status"包括以下状态:
- processing 任务处理中
- success 任务完成(如发送失败,回调三次)
- failed 任务失败(如发送失败,回调三次) Vidu采用回调签名算法进行认证,详情见:回调签名算法
响应
提交成功,返回视频任务对象。
任务 ID。
处理状态 可选值: created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败
created, queueing, processing, success, failed 本次调用的模型名称
本次调用的提示词参数
本次调用的视频时长参数
本次调用的随机种子参数
本次调用的 比例 参数
本次调用的分辨率参数
本次调用时传入的透传参数
本次调用使用的积分数
本次调用时是否使用错峰模式
本次提交任务是否使用水印
任务创建时间