Mureka 9.5 Lyrics Video
mureka/api/generate/lyrics-videoGenerate and edit video with Mureka 9.5 Lyrics Video from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
$0.13 per video.
Limits
- Runs
- In the background
- Returns
- video
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- Longest run, end to end
- 930 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
song_id | text | — | Generated audio ID from song_id in a song or instrumental response. Provide exactly one of song_id or upload_audio_id. |
upload_audio_id | text | — | Audio ID returned by /files/upload with purpose='audio'. Provide exactly one of song_id or upload_audio_id. |
background_id | text | — | Background image ID returned by /files/upload with purpose='lyrics-video'. |
cover_url | text | — | Optional public HTTPS URL or data URI for a JPG, PNG, or WebP cover. Not supported with layout_1. |
title | text | — | Optional title displayed in the lyrics video. |
aspect_ratio | one of 16:9, 9:16, 3:4, 4:3 | 9:16 | Output video aspect ratio. |
layout | one of layout_1, layout_2, layout_3, layout_4, layout_5, layout_6, layout_7 | layout_1 | Visual layout template for the lyrics video. |
lyrics_start_row | number (whole) 1 to … | — | First lyric row to include, starting at 1. Must be paired with lyrics_end_row and cannot be combined with a time selection. |
lyrics_end_row | number (whole) 1 to … | — | Last lyric row to include. Must be paired with lyrics_start_row and cannot be combined with a time selection. |
selection_start | number (whole) 0 to … | — | Start of the included audio range in milliseconds. Must be paired with selection_end and cannot be combined with lyric-row selection. |
selection_end | number (whole) 0 to … | — | End of the included audio range in milliseconds. Must be paired with selection_start and cannot be combined with lyric-row selection. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "fal",
"model": "mureka/api/generate/lyrics-video",
"input": {
"song_id": "<song_id>"
}
}'Frequently asked questions
How much does Mureka 9.5 Lyrics Video cost?
$0.13 per video. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Mureka 9.5 Lyrics Video through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "mureka/api/generate/lyrics-video"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with fal to use Mureka 9.5 Lyrics Video?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Mureka 9.5 Lyrics Video?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.