Vidu-reference-to-video-q3-ad

POST

/openapi/v2/vidu/reference-to-video-q3-ad

The balanced optimization version of Shengshu Technology's Vidu Q3 series reference-to-video model, delivering strong performance in visual quality and motion dynamics. Supports intelligent scene cutting and audio-visual synchronized generation. Generates 3-16 second videos at 720p and 1080p resolutions. Ideal for creative scenarios prioritizing balanced image quality and motion performance without subject library requirements.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "A magical floating island drifts high above the clouds. Giant windmills rotate slowly while a vast sea of white clouds stretches beneath. A young girl rides a flying bicycle through the sky, accompanied by small glowing creatures that flutter around her. The visual style resembles a hand-painted animated film with warm, soft colors and rich environmental detail. Layers of clouds fill the sky, and sunlight streams through them, creating beautiful volumetric light rays. The camera slowly moves forward as the girl smiles with joy and wonder. In the distance, castles, forests, waterfalls, and hidden villages appear among the clouds. The atmosphere is whimsical, comforting, and dreamlike, capturing the feeling of a magical adventure. Smooth character animation, highly detailed backgrounds, enchanting fantasy world, cinematic animated storytelling, filled with innocence and imagination.",
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=6e24ba3cff0bd024e43c9ce9166482d0a693b0a1c77661b005f58e9610e24845.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIyZTRiZGQ0NTM4N2YyNjRlM2UxZmFlNzRjODNmMWEzMyIsInNpZ25FeHBpcmUiOjE3ODM0MTc3MDQ1ODksInRzIjoxNzgyODEyOTA0NTg5LCJzaWduIjoiODY2YzdmZTlmNTkwYWY3M2MyNGU0Y2NhNzg3NmExYTYifQ==&Rh-Identify=2e4bdd45387f264e3e1fae74c83f1a33&rand=0.4241759859293791"
    ],
    "duration": 5,
    "resolution": "720p",
    "aspectRatio": "16:9",
    "audio": "true"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.runninghub.ai/openapi/v2/vidu/reference-to-video-q3-ad' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data '{
    "prompt": "A magical floating island drifts high above the clouds. Giant windmills rotate slowly while a vast sea of white clouds stretches beneath. A young girl rides a flying bicycle through the sky, accompanied by small glowing creatures that flutter around her. The visual style resembles a hand-painted animated film with warm, soft colors and rich environmental detail. Layers of clouds fill the sky, and sunlight streams through them, creating beautiful volumetric light rays. The camera slowly moves forward as the girl smiles with joy and wonder. In the distance, castles, forests, waterfalls, and hidden villages appear among the clouds. The atmosphere is whimsical, comforting, and dreamlike, capturing the feeling of a magical adventure. Smooth character animation, highly detailed backgrounds, enchanting fantasy world, cinematic animated storytelling, filled with innocence and imagination.",
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=6e24ba3cff0bd024e43c9ce9166482d0a693b0a1c77661b005f58e9610e24845.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIyZTRiZGQ0NTM4N2YyNjRlM2UxZmFlNzRjODNmMWEzMyIsInNpZ25FeHBpcmUiOjE3ODM0MTc3MDQ1ODksInRzIjoxNzgyODEyOTA0NTg5LCJzaWduIjoiODY2YzdmZTlmNTkwYWY3M2MyNGU0Y2NhNzg3NmExYTYifQ==&Rh-Identify=2e4bdd45387f264e3e1fae74c83f1a33&rand=0.4241759859293791"
    ],
    "duration": 5,
    "resolution": "720p",
    "aspectRatio": "16:9",
    "audio": "true"
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Bodyapplication/json

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-07-30 07:05:33

kling-video-o3-pro/reference-to-video

kling-video-o3-4k-reference-to-video