← All models
Creates a lyrics video from generated or uploaded audio, with selectable layouts, aspect ratios, backgrounds, and lyric-row or time-range selection.
Example
Details
- Accepts
- audio
Pricing
- Price
- 18.75 cr / video
Prices in credits (1 credit = $0.01).
Data schema
Input
| Field | Type | Description |
|---|---|---|
| title | — | Optional title displayed in the lyrics video. |
| layout | stringenum: layout_1, layout_2, layout_3, layout_4, layout_5, layout_6… | Visual layout template for the lyrics video. |
| song_id | — | Generated audio ID from song_id in a song or instrumental response. Provide exactly one of song_id or upload_audio_id. |
| cover_url | — | Optional public HTTPS URL or data URI for a JPG, PNG, or WebP cover. Not supported with layout_1. |
| aspect_ratio | stringenum: 16:9, 9:16, 3:4, 4:3 | Output video aspect ratio. |
| background_id | — | Background image ID returned by /files/upload with purpose='lyrics-video'. |
| selection_end | — | End of the included audio range in milliseconds. Must be paired with selection_start and cannot be combined with lyric-row selection. |
| lyrics_end_row | — | Last lyric row to include. Must be paired with lyrics_start_row and cannot be combined with a time selection. |
| selection_start | — | Start of the included audio range in milliseconds. Must be paired with selection_end and cannot be combined with lyric-row selection. |
| upload_audio_id | — | Audio ID returned by /files/upload with purpose='audio'. Provide exactly one of song_id or upload_audio_id. |
| lyrics_start_row | — | First lyric row to include, starting at 1. Must be paired with lyrics_end_row and cannot be combined with a time selection. |
Output
| Field | Type | Description |
|---|---|---|
| video | — | The generated video file. |