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"

extend_after
number<float>
required

Time in seconds after which to start the extension.

Example:

35

audio_file
file

Uploaded audio file to be extended.

prompt
string

Describes how the extended section should sound.

Example:

"Add a calming piano outro"

lyrics
string

Original lyrics of song

Maximum string length: 2000
Example:

"Let the journey fade away"

lyrics_section_to_extend
string

Lyrics to be used for the extended portion(optional, max 3000 characters).

Maximum string length: 3000
gender
enum<string>

Voice style if vocal content is generated.

Available options:
male,
female,
neutral
Example:

"neutral"

title
string

Title of the generated music track

num_outputs
number<integer>

The number of outputs to generate (1 or 2 only):default is 2.

generate_album_cover
boolean
default:false

Whether to generate an album cover for the generated audio

webhook_url
string

Callback URL for async processing results.

Example:

"https://example.com/webhook"

Response

Successfully initiated extend 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>