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://bucket.s3.amazonaws.com/audio.mp3"

prompt
string
required

Description of the singing style, tone, or genre.

Example:

"Sing emotional vocals over a soft piano instrumental."

lyrics
string
required

The lyrics to be sung over the instrumental.

Maximum string length: 2000
Example:

"Never mind I'll find someone like you..."

audio_file
file

Uploaded instrumental audio file.

gender
enum<string>

Voice gender to guide generation.

Available options:
male,
female,
neutral
Example:

"female"

title
string

Title of the generated music track

generate_album_cover
boolean
default:false

Whether to generate an album cover for the generated audio

webhook_url
string

Callback URL to receive status updates or final audio result.

Example:

"https://yourdomain.com/webhook"

Response

Successfully initiated sing over instrumental task

success
boolean
message
string
task_id
string
conversion_id_1
string
conversion_id_2
string
eta
integer

Estimated processing time in seconds

credit_estimate
number<float>