创建参考生视频任务

POST

/ent/v2/reference2video

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

{
    "model": "string",
    "subjects": [
        {
            "id": "string",
            "images": "string",
            "voice_id": "string"
        }
    ],
    "prompt": "string",
    "audio": "string",
    "duration": "string",
    "seed": "string",
    "aspect_ratio": "string",
    "movement_amplitude": "string",
    "payload": "string",
    "off_peak": "string",
    "watermark": "string",
    "wm_position": "string",
    "wm_url": "string",
    "meta_data": "string",
    "callback_url": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/ent/v2/reference2video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "string",
    "subjects": [
        {
            "id": "string",
            "images": "string",
            "voice_id": "string"
        }
    ],
    "prompt": "string",
    "audio": "string",
    "duration": "string",
    "seed": "string",
    "aspect_ratio": "string",
    "movement_amplitude": "string",
    "payload": "string",
    "off_peak": "string",
    "watermark": "string",
    "wm_position": "string",
    "wm_url": "string",
    "meta_data": "string",
    "callback_url": "string"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "task_id": "911084878697623552",
    "type": "character2video",
    "state": "created",
    "model": "viduq2",
    "style": "general",
    "prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨",
    "images": [
        "https://picx.zhimg.com/v2-4911df093b40ee5511938a1ac2a5cdc4_r.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": ""
}

修改于 2026-03-15 09:51:30

语音合成

创建首尾帧生视频任务