GET

/v1/schemas/fal/video/mureka/api/generate/lyrics-video

Accept:

kind inputactivity videohash 00c3b16f…extracted Oct 31, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `b4883d201bb0dbafe9747634e6fb8410f1100d108957dded5490bf514d46f4b9` { "fetchedAt": 1793422802, "extractorVersion": "1", "verifiedAt": null }

Request body

12 properties · 0 required · 0 $defs

property	type	description	constraints
lyrics_start_row	integer	First lyric row to include, starting at 1. Must be paired with lyrics_end_row and cannot be combined with a time selection. Provide either both lyric-row fields or both selection_start and selection_end. One complete pair is required.	n ≥ 1 · nullable
title	string	Optional title displayed in the lyrics video.	length ≥ 1 · nullable
background_id	string	Background image ID returned by /files/upload with purpose='lyrics-video'.	length ≥ 1 · nullable
song_id	string	Generated audio ID from song_id in a song or instrumental response. Provide exactly one of song_id or upload_audio_id.	length ≥ 1 · nullable
upload_audio_id	string	Audio ID returned by /files/upload with purpose='audio'. Provide exactly one of song_id or upload_audio_id.	length ≥ 1 · nullable
selection_end	integer	End of the included audio range in milliseconds. Must be paired with selection_start and cannot be combined with lyric-row selection. Provide either both time-selection fields or both lyrics_start_row and lyrics_end_row. One complete pair is required.	n ≥ 0 · nullable
aspect_ratio	enum	Output video aspect ratio.	16:9 \| 9:16 \| 3:4 \| 4:3 · default: "9:16"
layout	enum	Visual layout template for the lyrics video.	layout_1 \| layout_2 \| layout_3 \| layout_4 \| layout_5 \| layout_6 · +1 more · default: "layout_1"
selection_start	integer	Start of the included audio range in milliseconds. Must be paired with selection_end and cannot be combined with lyric-row selection. Provide either both time-selection fields or both lyrics_start_row and lyrics_end_row. One complete pair is required.	n ≥ 0 · nullable
lyrics_end_row	integer	Last lyric row to include. Must be paired with lyrics_start_row and cannot be combined with a time selection. Provide either both lyric-row fields or both selection_start and selection_end. One complete pair is required.	n ≥ 1 · nullable
enable_safety_checker	boolean	Authorized callers may set false to request relaxed screening.	default: true
cover_url	string	Optional public HTTPS URL or data URI for a JPG, PNG, or WebP cover. Not supported with layout_1.	nullable

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"mureka/api/generate/lyrics-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}