Song Generator
Generate full songs in 50+ languages by providing lyrics and a reference audio style using the ACE-Step v1.5 model.
POST
Generate song from lyrics and reference audio
Overview
The Song Generator API lets you create complete, production-quality songs by combining your lyrics with a reference audio file that defines the style, mood, and instrumentation. You can also skip writing lyrics entirely and let the model generate them automatically from a prompt.1
Write your lyrics and style
Provide your lyrics directly or enable auto-generation with a
prompt. Supply a caption describing the musical style : genre, instruments, vocal type, and mood.2
Configure audio and duration
Optionally attach a reference audio via
init_audio to influence the style further. Set the duration between 30 and 480 seconds.3
Receive your song
The API returns a hosted audio URL once generation is complete, or fires a webhook to your endpoint if provided.
Request
Make aPOST request to the endpoint below and pass the required parameters as a JSON body.
curl
Body Parameters
Set to
true to auto-generate lyrics from prompt. When false, provide lyrics directly.Song lyrics with section tags like
[Verse 1], [Chorus], [Bridge]. Required if lyrics_generation is false.Musical style descriptor : genre, instruments, vocal type, tempo, mood. E.g.
"female vocal, pop, piano, slow, emotional".Example Requests
With manual lyrics (
lyrics_generation: false)json
With auto lyrics generation (
lyrics_generation: true)json
Supported Languages
Body
application/json
- Auto-generate lyrics
- Manual lyrics
Response
Song generation response

