Vidu-image-to-video-q2-pro

POST

/openapi/v2/vidu/image-to-video-q2-pro

Vidu Q2 Pro is a high-performance Image-to-Video AI designed to breathe cinematic life into still frames. It excels at generating natural camera pans and fluid character animations while maintaining rigorous structural integrity. Unlike traditional tools, Q2 Pro focuses on "Identity Preservation," ensuring faces, hands, and intricate textures remain sharp and distortion-free. With its layout-aware dynamics, it delivers realistic parallax and consistent lighting, making backgrounds and foregrounds move in perfect harmony. Optimized for speed and quality, it empowers creators to produce social-ready, professional-grade clips that bridge the gap between photography and high-end cinematography.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "Generate a film-like short video based on the original image. The camera slowly pans from a close-up to a long shot, creating a natural depth-of-field transition. The girl’s hair flutters gently in the breeze, bamboo leaves sway softly, and faint ripples spread across the stream. Preserve the facial features, hair texture, costume embroidery details, and light and shadow layers of the original image throughout the entire process, with no distortion or deformation. Ensure smooth and natural dynamic effects, coherent visual logic, and color consistency with the original image.",
    "imageUrl": "https://www.runninghub.cn/view?filename=035f70a9f139adaeb935439154cef688fb1783bf3163ca315f746f02410981fd.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3Njk1NzgwMTE2NjcsInRzIjoxNzY4OTczMjExNjY3LCJzaWduIjoiYjE2Yzc3NDIzMmRkNTA2OGQ2MGJiY2UxMzcwYWRiYzIifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.32733159535151957",
    "duration": "5",
    "resolution": "720p",
    "movementAmplitude": "auto",
    "bgm": true
}

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/image-to-video-q2-pro' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "Generate a film-like short video based on the original image. The camera slowly pans from a close-up to a long shot, creating a natural depth-of-field transition. The girl’s hair flutters gently in the breeze, bamboo leaves sway softly, and faint ripples spread across the stream. Preserve the facial features, hair texture, costume embroidery details, and light and shadow layers of the original image throughout the entire process, with no distortion or deformation. Ensure smooth and natural dynamic effects, coherent visual logic, and color consistency with the original image.",
    "imageUrl": "https://www.runninghub.cn/view?filename=035f70a9f139adaeb935439154cef688fb1783bf3163ca315f746f02410981fd.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3Njk1NzgwMTE2NjcsInRzIjoxNzY4OTczMjExNjY3LCJzaWduIjoiYjE2Yzc3NDIzMmRkNTA2OGQ2MGJiY2UxMzcwYWRiYzIifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.32733159535151957",
    "duration": "5",
    "resolution": "720p",
    "movementAmplitude": "auto",
    "bgm": true
}'

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

Vidu-start-end-to-video-q2-pro

Vidu-image-to-video-q2-turbo