参考生视频(主体调用)

开发中

POST

/ent/v2/reference2video

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

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "model": "viduq3-turbo",
  "auto_subjects": true,
  "subjects": [
    {
      "name": "hero",
      "images": [
        "https://your-real-domain.com/hero.jpg"
      ]
    },
    {
      "name": "background",
      "images": [
        "https://your-real-domain.com/background.jpg"
      ]
    }
  ],
  "prompt": "让 @hero 在 @background 中奔跑，镜头跟随，电影质感，阳光明媚",
  "audio": true,
  "audio_type": "all",
  "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/watermark.png",
  "meta_data": "{\"Label\":\"reference2video_test\",\"ContentProducer\":\"MyStudio\",\"ContentPropagator\":\"MyStudio\",\"ProduceID\":\"prod_004\",\"PropagateID\":\"prop_004\",\"ReservedCode1\":\"res_007\",\"ReservedCode2\":\"res_008\"}",
  "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-raw '{
  "model": "viduq3-turbo",
  "auto_subjects": true,
  "subjects": [
    {
      "name": "hero",
      "images": [
        "https://your-real-domain.com/hero.jpg"
      ]
    },
    {
      "name": "background",
      "images": [
        "https://your-real-domain.com/background.jpg"
      ]
    }
  ],
  "prompt": "让 @hero 在 @background 中奔跑，镜头跟随，电影质感，阳光明媚",
  "audio": true,
  "audio_type": "all",
  "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/watermark.png",
  "meta_data": "{\"Label\":\"reference2video_test\",\"ContentProducer\":\"MyStudio\",\"ContentPropagator\":\"MyStudio\",\"ProduceID\":\"prod_004\",\"PropagateID\":\"prop_004\",\"ReservedCode1\":\"res_007\",\"ReservedCode2\":\"res_008\"}",
  "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

图生视频

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