Skip to main content
POST
Python

Authorizations

Authorization
string
header
required

Body

multipart/form-data
audio_url
string
required

Input audio URL (supported format: YouTube URL).

Example:

"https://mybucket.s3.amazonaws.com/song.mp3"

prompt
string
required

Describes how the audio should be transformed.

Example:

"Make it sound like Lo-fi with chill beats"

audio_file
file

Uploaded audio file to be remixed.

lyrics
string

Optional lyrics to guide vocal generation.

Maximum string length: 2000
Example:

"It's a brand new day"

title
string

Title of the generated music track

gender
enum<string>

Voice style if vocal content is generated.

Available options:
male,
female,
neutral
Example:

"female"

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

webhook_url
string

Callback URL for async processing results.

Example:

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

Response

Successful response

success
boolean
message
string
task_id
string
conversion_id_1
string
conversion_id_2
string
is_flagged
boolean
reason
string
eta
integer
status
string
credit_estimate
number
error_message
string
error_message_detail
string
missing_input_fields
string
predicted_user_intent
string