Make a music video
pixverse_create_music_videoMake a full music video from a song (audio_path: an uploaded MP3, 10 seconds to 6 minutes, or a library song) and optionally a character photo: performance (default), expressive or storytelling mode, a style, lyric captions, 720p or 1080p. Credits per second of song by mode and quality; the first music video of every account is free; quote: true answers the exact price and creates nothing. Waits up to ~50 s, then returns the video_id for pixverse_get_music_video. POST /music-video/create.
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": {
"audio_path": "<audio_path>"
},
"name": "pixverse_create_music_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Default performance. | |
| wait | No | Wait up to ~50 s for the job to finish (default true); false returns the id at once. | |
| No | The PixVerse account email (pixverse_list_accounts). Optional: by default a random account with a free slot. | ||
| quote | No | true returns the price and creates nothing (free). | |
| style | No | The look. performance / expressive: auto, custom, cinematic, underground, decadence, holiday, candy, woolen_felt, lo_fi, futuristic, chromatic_clash, golden_age, woodland_tale, dreamscape, voxel, retro_game, claymation, impressionism (default auto). storytelling: photorealistic, anime, 2d_modern_animation, cyberpunk, high_energy, digital_art, pixel_art, city_pop, y2k_collage, illustration, sketch, rock_haze, bubble_gum_punk, claymation, metal_noir, ghibli, midnight_blue_soul, lego_blocks (default photorealistic). | |
| lyrics | No | With subtitles: true, the lyrics one line per caption. | |
| prompt | No | storytelling only, and required there: the story to tell. | |
| maxJobs | No | Override the account's maxJobs (jobs at once) for this request, 1-8. | |
| quality | No | Default 720p. | |
| subtitles | No | true burns lyric captions into the video (a copy without them comes too); not with storytelling. | |
| audio_path | Yes | The song: a path from pixverse_upload_file (MP3) or a songs[].audio_path from pixverse_list_music_video_library. | |
| image_path | No | The performer: an uploaded photo or a library character; without it PixVerse invents one. | |
| music_genre | No | Helps PixVerse read the song; not with storytelling. | |
| aspect_ratio | No | Default 16:9. | |
| image_path_2 | No | storytelling only: a second character (needs image_path). | |
| style_image_path | No | With style custom only: an image whose look the video copies (upload or library style). |