pixverse-v6/image-to-video

POST

/openapi/v2/pixverse-v6/image-to-video

PixVerse V6 Image-to-Video animates a reference image into a cinematic video clip with natural motion. Upload a photo, describe the movement, and get high-quality animation preserving subject appearance and composition. Supports 360p-1080p, 1-15s duration, and optional audio. The Thinking mode allows the model to apply extended reasoning to complex or detailed scene descriptions, and with the built-in prompt enhancer tool, it automatically optimizes action descriptions to improve output content.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "imageUrl": "https://www.runninghub.cn/view?filename=dd40972fc667f1ab17ee45ca7d6a91a280061b5edb944e4b1bf053404c2c7d21.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzYyMTc1MDA5NjUsInRzIjoxNzc1NjEyNzAwOTY1LCJzaWduIjoiZTM3ODNiZjY1ZDQzZDYyMDZmYjdkNTBjMDA3NTFiYjIifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.12158875020171522",
    "prompt": "A joyful family of four playing on a sunny sandy beach. The mother, wearing a white tank top, denim shorts and sunglasses, smiles warmly while looking down at her children. The father in a white t-shirt and mint green shorts leans forward, playfully reaching out to the toddler. The older boy in a white tee and blue shorts steps closer to his mother curiously. The younger toddler in a white tee and mint shorts bounces excitedly toward his father with outstretched arms. A gentle sea breeze softly blows the mother's hair. Children laugh and move playfully, sand lightly scattering under their bare feet. Waves roll in slowly on the turquoise shoreline in the background. Warm golden sunlight, clear blue sky. Camera slowly dolly-in, cinematic and warm, shallow depth of field, family lifestyle photography style.",
    "resolution": "720p",
    "duration": 5,
    "generateAudioSwitch": true,
    "thinkingType": "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/pixverse-v6/image-to-video' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "imageUrl": "https://www.runninghub.cn/view?filename=dd40972fc667f1ab17ee45ca7d6a91a280061b5edb944e4b1bf053404c2c7d21.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzYyMTc1MDA5NjUsInRzIjoxNzc1NjEyNzAwOTY1LCJzaWduIjoiZTM3ODNiZjY1ZDQzZDYyMDZmYjdkNTBjMDA3NTFiYjIifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.12158875020171522",
    "prompt": "A joyful family of four playing on a sunny sandy beach. The mother, wearing a white tank top, denim shorts and sunglasses, smiles warmly while looking down at her children. The father in a white t-shirt and mint green shorts leans forward, playfully reaching out to the toddler. The older boy in a white tee and blue shorts steps closer to his mother curiously. The younger toddler in a white tee and mint shorts bounces excitedly toward his father with outstretched arms. A gentle sea breeze softly blows the mother'\''s hair. Children laugh and move playfully, sand lightly scattering under their bare feet. Waves roll in slowly on the turquoise shoreline in the background. Warm golden sunlight, clear blue sky. Camera slowly dolly-in, cinematic and warm, shallow depth of field, family lifestyle photography style.",
    "resolution": "720p",
    "duration": 5,
    "generateAudioSwitch": true,
    "thinkingType": "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-04-09 04:00:02

ltx-2.3/image-to-video-lora

wan-2.7-reference-to-video