← All models
Extends a generated song or uploaded audio from a specified timestamp using supplied lyrics, with head or tail extension depending on the selected model.
Details
- Accepts
- text
Pricing
- Price
- 0.500 cr / request
Prices in credits (1 credit = $0.01).
Data schema
Input
| Field | Type | Description |
|---|---|---|
| lyricsrequired | string | Lyrics for the extended section, up to 3,000 characters. |
| song_id | — | Generated song ID from song_id in a /generate/song response. Provide exactly one of song_id or upload_audio_id. |
| extend_atrequired | integer | Timestamp in milliseconds where extension begins. |
| extend_type | stringenum: tail, head | Direction of extension: append to the tail or prepend to the head. |
| upload_audio_id | — | Audio ID returned by /files/upload with purpose='audio'. Provide exactly one of song_id or upload_audio_id. |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. |
Output
| Field | Type | Description |
|---|---|---|
| audio | — | The generated audio file. |
| song_id | — | Reusable identifier for this audio. Pass it to endpoints that accept song_id. |
| duration | — | Duration of the generated audio in milliseconds, when available. |
| lyrics_sections | — | Timed lyric sections for the generated audio, when available. |