Skip to main content
POST
Python
Generate a sung vocal performance over an instrumental audio track using a style prompt and lyrics.

Endpoint

This endpoint enables you to overlay vocals onto an instrumental audio using a textual description of the singing style and provided lyrics. Input can be either a file upload or a URL.

Request Parameters

💡 Note: You must provide either audio_file or audio_url — at least one is required.
content-type: multipart/form-data

Sample Output

Listen to a real output: Prompt: sing over instrumental in classical slow vibe - audio input : Moana How Far We will Go. Download Audio

Try it Yourself

Use the Sing Over Insturmental Endpoint Explorer to test this endpoint live with your own inputs.

Sample Request

cURL

Python

🔐 Be sure to replace the placeholders like <api_key> and file paths with real values.

Sample Response

Success (200 OK)


Webhook Response

When the process completes, the provided webhook_url (if any) will receive a JSON POST with:

Webhook Delivery

Once the generation is complete, webhooks will be triggered to deliver the following:

Standard Requests (non-instrumental):

  • 2 (webhooks) x Sing Over conversion details (one per version)
  • 2 (webhooks) x Lyrics with timestamp data
  • 1 Album Cover Image
Webhook responses include detailed metadata including task_id, conversion_id, audio files (conversion_path), lyrics etc.

Common Errors

  • 422 Unprocessable Entity: Missing required fields like prompt or lyrics, or no audio input provided.
  • 500 Internal Server Error: Unexpected error during processing.

Use this endpoint to effortlessly bring your lyrics to life with expressive vocals over any instrumental.

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>