Vidu-reference-to-video-q2

POST

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

Vidu Q2 Reference-to-Video transforms static concepts into expressive, cinematic narratives with exceptional fidelity. It excels at capturing subtle micro-expressions, rhythmic breathing, and authentic eye movements, breathing life into portraits with remarkable realism. Supporting up to seven reference images for multi-angle guidance, it provides granular control over motion amplitude and complex camera dynamics like pans and zooms. With professional-grade identity preservation and flexible aspect ratios, it is the premier solution for creators seeking to bridge the gap between high-end static imagery and fluid, emotional storytelling.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "Generate a cinematic portrait short video based on the reference images, and accurately restore the consistency of the character's facial features and light/shadow ambiance; enable the micro-expression restoration feature to present natural blinking movements, slow eye rotation trajectories, and subtle neck movements caused by breathing; set the motion intensity to \"slight\" to avoid facial distortion; camera movement: slowly push in from the close-up of Reference Image to an extreme close-up, then smoothly pan around to transition to the three-quarter profile angle of Reference Image, and finally pull back to a close-up; maintain smooth and coherent footage throughout, ensure color consistency with the original images, and eliminate any extra irrelevant motion interference.",
    "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"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.ai/openapi/v2/vidu/reference-to-video-q2' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "Generate a cinematic portrait short video based on the reference images, and accurately restore the consistency of the character'\''s facial features and light/shadow ambiance; enable the micro-expression restoration feature to present natural blinking movements, slow eye rotation trajectories, and subtle neck movements caused by breathing; set the motion intensity to \"slight\" to avoid facial distortion; camera movement: slowly push in from the close-up of Reference Image to an extreme close-up, then smoothly pan around to transition to the three-quarter profile angle of Reference Image, and finally pull back to a close-up; maintain smooth and coherent footage throughout, ensure color consistency with the original images, and eliminate any extra irrelevant motion interference.",
    "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"
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Body

Examples

Submit response exampleTask success response example

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

Modified at 2026-03-10 12:42:16

seedance-2.0/multimodal-video

seedance-2.0-fast/multimodal-video