4Z API

参考生图

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

参考图片生成图像。

请求体 (application/json)

  • model (string, 必填): 模型名称 可选值：vidu-image-q2 支持文生图（不传 images）与参考生图（传 1～7 张图） 注：传 viduq2 也可以，等同于 vidu-image-q2
  • prompt (string, 必填): 文本提示词 图片生成的文本描述，长度不能超过 2000 个字符 注1：不传 images 时，模型会使用该参数的文本内容生成图片（文生图）
  • aspect_ratio (string): 比例参数，不同模型支持不同的比例： vidu-image-q2：默认值16:9，可选值如下：16:9、9:16、1:1、3:4、4:3、21:9、2:3、3:2 - auto：表示与首张输入图保持相同比例
  • callback_url (string): Callback 协议 需要您在创建任务时主动设置 callback_url，请求方法为 POST，当图片生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致 回调返回的“status”包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法
  • images (array): 图像参考 支持输入 0～7 张图片，不传时为文生图 模型将以此参数中传入的图片中的主题为参考，生成与图片中主体一致的图片。 注1：支持传入图片 Base64 编码或图片URL（确保可访问) 注2：图片支持 png、jpeg、jpg、webp格式 注3：图片像素不能小于 128*128，且比例需要小于1:4或者4:1 注4: 且大小不超过50M 注5：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
  • payload (string): 透传参数 不做任何处理，仅数据传输 注：最多 1048576个字符
  • resolution (string): 分辨率参数，不同模型支持的分辨率不同： vidu-image-q2：默认1080p，可选项：1080p、2K、4K
  • seed (string): 随机种子参数 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子

请求示例

{
  "model": "vidu-image-q2",
  "prompt": "一只可爱的小猫坐在窗台上，阳光洒在它的身上，温馨的画面"
}