Skip to main content
POST
Generate Custom Music

Authorizations

Authorization
string
header
required

Body

application/json
prompt
string

A natural language prompt for music generation. Keep it under 300 characters. Be clear and descriptive for better results.

music_style
string

Style of music to generate (e.g., Rock, Pop)

Example:

"Lo-fi"

lyrics
string

Custom lyrics for the generated music

make_instrumental
boolean
default:false

Whether to make the music instrumental

vocal_only
boolean
default:false

Whether to generate only vocals of output audio

title
string

Title of the generated music track

Example:

"My Generated Track"

gender
string

Gender of the voice model

Example:

"female"

voice_id
string

Voice model to convert generated audio

Example:

"e1cb7380-e3db-433a-b186-a996d7545986"

generate_album_cover
boolean
default:false

Whether to generate an album cover for the generated audio

lyrics_timestamps
boolean
default:false

Whether to generate timestamps for the lyrics

model
enum<string>

Model version to use for generation

Available options:
v6,
v6-pro,
v7,
v7-pro
Example:

"v7"

webhook_url
string

URL for callback upon completion

Example:

"https://example.com/my-webhook"

Response

Successful response

success
boolean
message
string
task_id
string
conversion_id_1
string
conversion_id_2
string
eta
integer
is_flagged
boolean
reason
string
credit_estimate
number