Skip to main content
PUT
create.remix_song

Body

application/json
idempotency_key
string<uuid>
required

A unique UUID you choose. Send the same key to retry safely; we'll return the original response without doing the work again.

source
AudioSource · object
required

The song (with vocals) to remix. The audio must be a WAV, MP3, or FLAC file between 10 seconds and 5 minutes long, and at most 50 MB.

lyrics
string
required

Song lyrics. Use [Verse], [Chorus], [Bridge], [Intro], [Outro], [Instrumental] section markers on their own line to structure the song. Each subsequent line within a section is a separate vocal line.

Example:

Required string length: 1 - 3000
prompt
string
required

Free-text description of the audio to generate. Mix tags, a description of the desired mood and instrumentation, and a scene — use commas to separate tags. Examples: rock song, energetic, male vocal (song), synthwave, melancholic, mid-tempo (instrumental), rock, guitar, energetic, no drums (sample), someone typing on a keyboard (effect).

Required string length: 1 - 1024
callback_url
string<uri> | null

Optional HTTPS URL we'll POST the final response to when the operation reaches ready or failed. Polling remains the canonical source of truth; webhooks are a best-effort latency optimisation.

Required string length: 1 - 2048
n_variations
integer
default:1

How many output variations to produce (1-3).

Required range: 1 <= x <= 3

Response

Successful Response

remixed_song
RemixedSong · object
required