创建参考生视频任务（主体调用）

POSThttps://www.aipro2.com/ent/v2/reference2video

官方文档:https://platform.vidu.cn/docs/reference-to-video

请求体参数

application/json

• aspect_ratiostring
  比例参数，q2、q3模型支持任意比例或 auto
  默认 16:9，可选值如下：1:1、9:16、16:9、3:4、4:3
  auto：根据输入图或视频自动推荐
• audiostring
  是否使用音视频直出能力，默认false，可选值 true、false
  - true：使用音视频直出能力。
  - false：不使用音视频直出能力。
  注：viduq3 模型默认值为true
• auto_subjectsstring
  - 是否使用智能主体库能力，默认false，可选值 true、false
  - true：使用智能主体库能力。
  - false：不使用智能主体库能力。
• callback_urlstring
  Callback 协议
  需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
  回调返回的"status"包括以下状态：
  - processing 任务处理中
  - success 任务完成（如发送失败，回调三次）
  - failed 任务失败（如发送失败，回调三次）
  Vidu采用回调签名算法进行认证，详情见：回调签名算法
• durationnumber
  视频时长参数，默认值依据模型而定
  viduq3：默认5秒，可选：3 - 16
  viduq2-pro、viduq2：默认5秒，可选：1 - 10
  viduq1：默认5秒，可选：5
  vidu2.0：默认4秒，可选：4
• meta_datastring
  元数据标识，json格式字符串，透传字段，您可以 自定义格式 或使用 示例格式 ，示例如下：
  {
  "Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
  }
  该参数为空时，默认使用vidu生成的元数据标识
• model*string
  模型名称可选值：viduq3-mix、viduq3、viduq2-pro、viduq2、viduq1、vidu2.0
  - viduq3-mix：画面质感强，支持智能切镜，支持音画同出，动态效果好，均衡性最强
  - viduq3：支持智能切镜，支持音画同出，多机位的一致性更出色
  - viduq2-pro：支持参考视频，支持视频编辑，视频替换
  - viduq2：动态效果好，生成细节丰富
  - viduq1：画面清晰，平滑转场，运镜稳定
  - vidu2.0：生成速度快
• movement_amplitudestring
  运动幅度默认 auto，可选值：auto、small、medium、large
  注：使用q2、q3系列模型时该参数不生效
• payloadstring
  透传参数
  不做任何处理，仅数据传输
  注：最多 1048576个字符
• prompt*string
  文本提示词
  生成视频的文本描述。
  注：字符长度不能超过 2000 个字符
• resolutionstring
  分辨率参数，默认值依据模型和视频时长而定：
  viduq3（3-16秒）：默认 720p, 可选：540p、720p、1080p
  viduq2-pro、viduq2 （1-10秒）：默认 720p, 可选：540p、720p、1080p
  viduq1 （5秒）：默认 1080p, 可选：1080p
  vidu2.0 （4秒）：默认 360p, 可选：360p、720p
• seedstring
  随机种子
  当默认不传或者传0时，会使用随机数替代
  手动设置则使用设置的种子
• subjects*array<object>
  图片主体信息支持1-7个主体，主体图片共1 ～ 7张
• watermarkstring
  是否添加水印
  - true：添加水印；
  - false：不添加水印；
  注1：目前水印内容为固定，内容由AI生成，默认不加
  注2：您可以通过watermarked_url参数查询获取带水印的视频内容，详情见查询任务接口
• wm_positionstring
  水印位置，表示水印出现在图片的位置，可选项为：
  1：左上角
  2：右上角
  3：右下角
  4：左下角
  默认为：3
• wm_urlstring
  水印内容，此处为图片URL
  不传时，使用默认水印：内容由AI生成

响应

成功

application/json

无响应结构说明

请求体示例创建参考生视频任务（主体调用）创建参考生视频任务（非主体调用）

1{2  "model": "viduq2",3  "prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨",4  "subjects": [5    {6      "id": "cat",7      "images": [8        "https://c-ssl.duitang.com/uploads/blog/202306/19/y9S765GQCblz752.jpg"9      ]10    }11  ]12}

代码示例cURLPythonJavaScriptGoPHP

1curl -X POST "https://www.aipro2.com/ent/v2/reference2video" \2  -H "Authorization: Bearer <API Key>" \3  -H "Content-Type: application/json" \4  -d '{5    "model": "viduq2",6    "prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨",7    "subjects": [8      {9        "id": "cat",10        "images": [11          "https://c-ssl.duitang.com/uploads/blog/202306/19/y9S765GQCblz752.jpg"12        ]13      }14    ]15  }'

响应示例 · 200成功示例

1{2  "aspect_ratio": "16:9",3  "client_request_id": "",4  "created_at": "2026-01-20T06:37:57.371761937Z",5  "credits": 45,6  "cus_priority": 0,7  "duration": 5,8  "images": [9    "https://picx.zhimg.com/v2-4911df093b40ee5511938a1ac2a5cdc4_r.jpg"10  ],11  "is_rec": false,12  "meta_data": "",13  "model": "viduq2",14  "movement_amplitude": "auto",15  "off_peak": false,16  "payload": "",17  "prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨",18  "resolution": "720p",19  "seed": 1830691647,20  "state": "created",21  "style": "general",22  "task_id": "911084878697623552",23  "type": "character2video",24  "watermark": false,25  "wm_position": "unspecified",26  "wm_url": ""27}