创建 Vidu 参考生视频任务

POST

/domi/providers/vidu/ent/v2/reference2video

当前网关支持的模型（请求 model 直接填写）：viduq3-mix、viduq3-turbo、viduq3、viduq2-pro、viduq2、viduq1、vidu2.0。列表依据仓库 SQL 配置，实际可用性取决于部署环境启用配置及 NewAPI 授权。

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

网关按端点和请求参数选择唯一的受控配置，创建后异步轮询。仅当 Vidu 返回 success 时，才将结果中的 credits 作为 completion tokens 调用 NewAPI 结算；失败、取消任务不收费。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "model": "viduq3",
    "subjects": [
        {
            "name": "your_subject1_name",
            "images": [
                "your_image_url1",
                "your_image_url2",
                "your_image_url3"
            ],
            "voice_id": ""
        },
        {
            "name": "your_subject2_name",
            "images": [
                "your_image_url4",
                "your_image_url5",
                "your_image_url6"
            ],
            "voice_id": ""
        }
    ],
    "prompt": "@your_subject1_name 和 @your_subject2_name 在一起吃火锅，并且旁白音说火锅大家都爱吃。",
    "duration": 8,
    "audio": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway.domi-kids.com/domi/providers/vidu/ent/v2/reference2video' \
--header 'domi-ai-metadata;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "viduq3",
    "subjects": [
        {
            "name": "your_subject1_name",
            "images": [
                "your_image_url1",
                "your_image_url2",
                "your_image_url3"
            ],
            "voice_id": ""
        },
        {
            "name": "your_subject2_name",
            "images": [
                "your_image_url4",
                "your_image_url5",
                "your_image_url6"
            ],
            "voice_id": ""
        }
    ],
    "prompt": "@your_subject1_name 和 @your_subject2_name 在一起吃火锅，并且旁白音说火锅大家都爱吃。",
    "duration": 8,
    "audio": true
}'

返回响应

🟢200

application/json

创建成功，返回 Vidu 任务 ID

Bodyapplication/json

示例

{
    "task_id": "task_018f840081627e03",
    "state": "created"
}

🟠400

🟠401

🟠4XX

🔴5XX

修改于 2026-09-16 09:19:31

查询 MiniMax H3 视频生成任务

创建 Vidu 文生视频任务