GET
/v1/schemas/fal/video/pixverse/music-video/vibemv
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source traceb24abe621b9611e740e1db196e20c3dbf2cad88f2ae30fed57d5ff51adfda4ca{
"fetchedAt": 1791522002,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
10 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| audio_url* | string | URL of an MP3 or WAV file between 10 seconds and 6 minutes. | |
| style_image_url | string | Optional style reference image URL. Only used with the Custom style. | nullable |
| image_url | string | Optional character reference image URL. | nullable |
| aspect_ratio | enum | Aspect ratio of the generated video. | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 · default: "16:9" |
| music_style | enum | Optional musical genre used to guide the visuals. | Pop | Rock | Hip Hop | R&B | Jazz | Reggae · +9 more · nullable |
| style | enum | Visual style for the music video. | Custom | Cinematic | Lo-fi | Dreamscape | Woolen Felt | Candy · +10 more · default: "Cinematic" |
| lyrics | string | Optional lyrics to display as subtitles. | length ≤ 5000 · nullable |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| resolution | enum | Resolution of the generated video. | 720p | 1080p · default: "720p" |
| lip_sync_switch | boolean | Enable lip sync so characters mouth the vocals. Works best with a character reference image. | default: false |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"pixverse/music-video/vibemv","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}