4Z API

图生视频

接口: POST https://4zapi.com/ent/v2/img2video

以首帧图片生成视频。

请求体 (application/json)

  • images (array, 必填): 首帧图像 模型将以此参数中传入的图片为首帧画面来生成视频。 注1：支持传入图片 Base64 编码或图片URL（确保可访问）； 注2：只支持输入 1 张图； 注3：图片支持 png、jpeg、jpg、webp格式； 注4：图片比例需要小于 1:4 或者 4:1 ； 注5：图片大小不超过 50 MB； 注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
  • model (string, 必填): 模型名称 可选值：viduq4-preview、viduq3-pro、viduq3-turbo、viduq2-pro、viduq2-turbo - viduq4-preview：Q4 预览版，时长 3–16 秒，分辨率 540p / 720p / 1080p / 2K / 4K；不传 audio 时默认生成音频 - viduq3-turbo：对比 viduq3-pro，生成速度更快 - viduq3-pro：高效生成优质音视频内容，让视频内容更生动、更形象、更立体，效果更好 - viduq2-pro：Q2 专业版，画面效果更好 - viduq2-turbo：Q2 快速版，生成更快 注：图生视频不支持 viduq2（不带后缀），传入会返回 400，请用 viduq2-pro 或 viduq2-turbo
  • prompt (string, 必填): 文本提示词，生成视频的文本描述，可选。 长度上限：viduq4-preview 5000 个字符，其他模型 2000 个字符。
  • audio (string): 是否使用音视频直出能力，默认 false： - false：输出静音视频 - true：输出带台词和背景音的视频 注1：为 true 时 voice_id 才生效 注2：为 true 时不支持错峰模式 注3：viduq4-preview 不传 audio 时默认生成音频
  • callback_url (string): Callback 协议 需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致 回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法 注：viduq4-preview 不支持回调，请通过查询任务接口获取结果
  • duration (number): 视频时长参数，默认值依据模型而定： - viduq4-preview：默认 5，可选：3 - 16 - viduq3-pro、viduq3-turbo：默认 5，可选：1 - 16 - viduq2-pro、viduq2-turbo：默认 5，可选：1 - 10 - viduq4-preview：默认 5，可选：3 - 16（已有，不用改）
  • is_rec (string): 是否使用推荐提示词： - true：由系统自动推荐提示词并据此生成视频（推荐 1 条） - false：按传入的 prompt 生成视频
  • meta_data (string): 元数据标识，json格式字符串，透传字段，您可以 自定义格式 或使用 示例格式 ，示例如下： { "Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2" } 该参数为空时，默认使用vidu生成的元数据标识 注：viduq4-preview 不支持该参数
  • movement_amplitude (string): 运动幅度 默认 auto，可选值：auto、small、medium、large 注：使用q2模型时该参数不生效 注：viduq4-preview 不支持该参数
  • off_peak (string): 错峰模式，默认 false： - true：错峰生成，任务会在 48 小时内完成，未完成的任务会被自动取消；也可以手动取消 - false：即时生成 注：viduq4-preview 不支持错峰模式
  • payload (string): 透传参数 不做任何处理，仅数据传输 注：最多 1048576个字符
  • resolution (string): 分辨率参数，默认值依据模型和视频时长而定： - viduq3-pro、viduq3-turbo 1-16秒：默认 720p，可选：540p、720p、1080p - viduq2-pro、viduq2-turbo 1-10秒：默认 720p，可选：540p、720p、1080p - viduq4-preview：默认 720p，可选 540p、720p、1080p、2K、4K
  • seed (string): 随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子
  • voice_id (string): 音色id 用来决定视频中的声音音色，为空时系统会自动推荐，可选枚举值参考列表：新音色列表：https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
  • watermark (string): 是否添加水印 - true：添加水印； - false：不添加水印； 注1：目前水印内容为固定，内容由AI生成，默认不加 注2：您可以通过watermarked_url参数查询获取带水印的视频内容，详情见查询任务接口
  • wm_position (string): 水印位置，表示水印出现在图片的位置，可选项为： 1：左上角 2：右上角 3：右下角 4：左下角 默认为：3
  • wm_url (string): 水印内容，此处为图片URL 不传时，使用默认水印：内容由AI生成

请求示例

{
  "audio": false,
  "duration": 5,
  "images": [
    "https://imageproxy.zhongzhuan.chat/api/proxy/image/6fb238cc01649cb7580fbb2dd58f3d6d.png"
  ],
  "model": "viduq2-pro",
  "movement_amplitude": "auto",
  "off_peak": false,
  "prompt": "镜头缓慢推进，展现画面中的细节，背景逐渐虚化",
  "resolution": "1080p",
  "seed": 12345,
  "watermark": false
}