Vidu-参考生视频-q2

POST

/openapi/v2/vidu/reference-to-video-q2

旗舰级参考生视频模型，擅长将单张或多张（最高 7 张）参考图转化为极具表现力的电影级动态影像。其核心突破在于对“微表情”的细腻还原，能够精准呈现眨眼、眼球转动及自然的呼吸起伏。模型不仅提供了强大的运动幅度控制功能（从微动到大动作可选），还集成了专业的摄影机运镜指令。凭借对多图参考的支持，它能更好地捕捉角色的多角度特征与光影氛围，是肖像活化、虚拟数字人及概念视觉开发的顶尖生产力工具。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "prompt": "基于参考图生成电影级人像短视频，精准还原角色面部特征与光影氛围一致性；启用微表情还原功能，呈现自然的眨眼动作、眼球缓慢转动轨迹及颈部呼吸起伏微动；运动幅度设置为「轻微」，避免面部扭曲；摄影机运镜：从参考图的近景缓慢推至特写，再平滑环绕切换至参考图的四分之三侧面角度，最后拉回近景；全程保持画面丝滑连贯，色彩与原图一致，无多余动态干扰",
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=4bfe72ddf7cd8a14033f137baea4602ba59ca4aa097e6b165d9a75be0f547454.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3Njk1ODY3MzY1NjAsInRzIjoxNzY4OTgxOTM2NTYwLCJzaWduIjoiNDE3NGI3ZTgyODk5N2ZjOWZjOTQ5Yjg3YWE2ZGEwN2MifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.38298866106307117"
    ],
    "aspectRatio": "3:4",
    "resolution": "1080p",
    "duration": "5",
    "movementAmplitude": "auto"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.cn/openapi/v2/vidu/reference-to-video-q2' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "基于参考图生成电影级人像短视频，精准还原角色面部特征与光影氛围一致性；启用微表情还原功能，呈现自然的眨眼动作、眼球缓慢转动轨迹及颈部呼吸起伏微动；运动幅度设置为「轻微」，避免面部扭曲；摄影机运镜：从参考图的近景缓慢推至特写，再平滑环绕切换至参考图的四分之三侧面角度，最后拉回近景；全程保持画面丝滑连贯，色彩与原图一致，无多余动态干扰",
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=4bfe72ddf7cd8a14033f137baea4602ba59ca4aa097e6b165d9a75be0f547454.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3Njk1ODY3MzY1NjAsInRzIjoxNzY4OTgxOTM2NTYwLCJzaWduIjoiNDE3NGI3ZTgyODk5N2ZjOWZjOTQ5Yjg3YWE2ZGEwN2MifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.38298866106307117"
    ],
    "aspectRatio": "3:4",
    "resolution": "1080p",
    "duration": "5",
    "movementAmplitude": "auto"
}'

返回响应

🟢200成功

application/json

任务结果查询接口：/openapi/v2/query

Body

示例

提交任务响应示例任务完成（查询状态接口）响应示例

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

修改于 2026-03-10 12:42:16

Vidu-参考生视频-q3

可灵参考生视频o1