参考生视频(非主体调用)

开发中

POST

/ent/v2/reference2video

以参考图片/视频的主体一致性生成视频，支持主体库功能。该接口包含两种调用方式：使用主体调用（通过 subjects 参数）和非主体调用（通过 images/videos 参数）。

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "model": "viduq3-turbo",
  "images": [
    "https://your-real-domain.com/reference1.jpg",
    "https://your-real-domain.com/reference2.jpg"
  ],
  "prompt": "镜头缓慢推进，画面中的角色开始奔跑，背景的霓虹灯逐渐亮起，电影质感，阳光明媚",
  "audio": true,
  "duration": 10,
  "seed": 42,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "payload": "custom_reference2video_payload_001",
  "off_peak": true,
  "watermark": true,
  "wm_position": 2,
  "wm_url": "https://your-real-domain.com/my-custom-watermark.png",
  "meta_data": "{\"Label\":\"reference2video_test\",\"ContentProducer\":\"MyStudio\",\"ContentPropagator\":\"MyStudio\",\"ProduceID\":\"prod_005\",\"PropagateID\":\"prop_005\",\"ReservedCode1\":\"res_009\",\"ReservedCode2\":\"res_010\"}",
  "callback_url": "https://your-server.com/api/reference2video-callback"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.northrouter.com/ent/v2/reference2video' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
  "model": "viduq3-turbo",
  "images": [
    "https://your-real-domain.com/reference1.jpg",
    "https://your-real-domain.com/reference2.jpg"
  ],
  "prompt": "镜头缓慢推进，画面中的角色开始奔跑，背景的霓虹灯逐渐亮起，电影质感，阳光明媚",
  "audio": true,
  "duration": 10,
  "seed": 42,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "payload": "custom_reference2video_payload_001",
  "off_peak": true,
  "watermark": true,
  "wm_position": 2,
  "wm_url": "https://your-real-domain.com/my-custom-watermark.png",
  "meta_data": "{\"Label\":\"reference2video_test\",\"ContentProducer\":\"MyStudio\",\"ContentPropagator\":\"MyStudio\",\"ProduceID\":\"prod_005\",\"PropagateID\":\"prop_005\",\"ReservedCode1\":\"res_009\",\"ReservedCode2\":\"res_010\"}",
  "callback_url": "https://your-server.com/api/reference2video-callback"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{"id":"task_Ck7KwfffITlgXsa1Lr8LCOEvrSKSWRHO","task_id":"task_Ck7KwfffITlgXsa1Lr8LCOEvrSKSWRHO","object":"video","model":"viduq3-pro","status":"queued","progress":0,"created_at":1788447277}

修改于 2026-09-21 13:52:22

参考生视频(主体调用)

首尾帧视频