create.remix_song
Submit a song remix request.
Returns immediately with status: processing. Use the matching GET to
poll for completion, or supply a callback_url to receive a webhook.
Takes an existing song with vocals/lyrics and produces new song
variations of it, guided by the lyrics and prompt you supply. For
remixing an instrumental track (no vocals), use
create.remix_instrumental instead. Set n_variations (1-3) for how
many variations to produce — each appears as a separate entry in
outputs when the operation is ready.
Credits cost: 3 per variation (so n_variations: 2 costs 6).
Insufficient credits returns 402 — see errors.
Body
A unique UUID you choose. Send the same key to retry safely; we'll return the original response without doing the work again.
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.
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:
1 - 3000Free-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).
1 - 1024Optional 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.
1 - 2048How many output variations to produce (1-3).
1 <= x <= 3Response
Successful Response
