Video from reference images, videos and audio
pixverse_create_video_fusionGenerate a video from reference images (and, on models that take them, reference videos and audio) cited in the prompt as @image1, @video1, @audio1 (PixVerse's Reference mode), with V5 (default), V5.6, C1 or third-party models (Seedance, Kling 4.0 / O3, MiniMax H3, Wan 3.0, Gemini Omni Flash); each model takes its own number of references. Naming a model makes duration and quality required. Uses PixVerse credits. Waits up to ~50 s, then returns the video_id for pixverse_get_video. POST /videos/create-fusion.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "pixverse_create_video_fusion"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Seed for a repeatable result (native PixVerse models only). | |
| wait | No | Wait up to ~50 s for the job to finish (default true); false returns the id at once. | |
| audio | No | true adds generated sound where the model has an audio toggle (see the model capabilities page). | |
| No | The PixVerse account email (pixverse_list_accounts). Optional: by default a random account with a free slot. | ||
| model | No | Default v5 (with duration 5 and quality 540p). | |
| prompt | Yes | What happens, citing @image1..@imageN, @video1.., @audio1.. in order. | |
| maxJobs | No | Override the account's maxJobs (jobs at once) for this request, 1-8. | |
| quality | No | Required when model is given. | |
| duration | No | Seconds; required when model is given. | |
| relax_mode | No | Third-party models only (400 on PixVerse's own). Left out (or true), the plan's discount for the model applies; false pays the full price. | |
| audio_paths | No | Reference audio (@audio1 first), on the models that take them, up to 10. | |
| image_paths | No | Reference images in order (@image1 first): paths from pixverse_upload_file. Up to 30 by model (v5 3, v5.6 and pixverse-c1 7). | |
| video_paths | No | Reference videos (@video1 first), on the models that take them, up to 10. | |
| aspect_ratio | No | Default 16:9. | |
| preview_mode | No | true makes a fast lower-quality preview at 20% off credits (native PixVerse models only, paid plans). | |
| off_peak_mode | No | true runs it in Off-Peak mode at a lower credit cost (native PixVerse models; the discount depends on the plan). Such a job is not waited for: read it later with pixverse_get_video. |