欢迎访问 n1n 在线文档！平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！

Vidu 参考生视频

POST

https://api.n1n.ai/ent/v2/reference2video

Last modified:2026-02-19 18:34:50

Vidu 参考生视频接口分为音视频直出、视频直出功能，二者使用相同的接口地址与请求方式，请求体不同，参考下方示例。
参考生视频-音视频直出：您可以指定视频中的主体用台词对话，直接生成完整的音视频；
参考生视频-视频直出：为视频的场景配置对应背景音乐，不含台词。
viduq2-pro模型，目前仅支持非主体调用

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

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Example

{
    "model": "viduq2",
    "subjects": [
        {
            "id": "cat",
            "images": [
                "https://example.com/image/xxxx.png"
            ]
        }
    ],
    "prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.n1n.ai/ent/v2/reference2video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "viduq2",
    "subjects": [
        {
            "id": "cat",
            "images": [
                "https://example.com/image/xxxx.png"
            ]
        }
    ],
    "prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨"
}'

Responses

🟢200成功

application/json

Body

Example

{
    "task_id": "911084878697623552",
    "type": "character2video",
    "state": "created",
    "model": "viduq2",
    "style": "general",
    "prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨",
    "images": [
        "https://example.com/image/xxxx.jpg"
    ],
    "duration": 5,
    "seed": 1830691647,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "movement_amplitude": "auto",
    "created_at": "2026-01-20T06:37:57.371761937Z",
    "credits": 45,
    "payload": "",
    "cus_priority": 0,
    "off_peak": false,
    "watermark": false,
    "is_rec": false,
    "wm_position": "unspecified",
    "wm_url": "",
    "meta_data": "",
    "client_request_id": ""
}

Modified at 2026-02-19 18:34:50

Vidu 文生音频

Vidu 首尾帧生视频