Skip to main content
POST
Python
Convert an audio file or URL into a cover song using a different voice model. The Cover Song endpoint recreates a vocal track using AI voice models, allowing for pitch manipulation and background audio transformation. Perfect for covers, remixes, or experimenting with different vocal styles.

Endpoint

This is the primary endpoint for initiating cover song conversion tasks.

Sample Output

Listen to a real sample output: Output File: Download Audio

Try it Yourself

Visit the Cover Endpoint Explorer to test it live. Upload your audio, select a voice model, and hear the transformation.

Request Parameters

💡Note: You must provide either audio_url or audio_file — not both as None.
content-type: multipart/form-data

Sample Request

cURL

Python

Replace {path_to_your_audio_file}, api_key, and webhook_url before executing.

Sample Response

Success (200 OK)


Common Errors

  • 400 Bad Request: The file could not be downloaded from the provided URL.
  • 402 Payment Required: Your credit balance is insufficient.
  • 422 Unprocessable Entity: No audio_url or audio_file provided.
  • 500 Internal Server Error: Something went wrong on our end.

Webhook Response

When the cover conversion completes, the webhook receives:
You can download or stream the result directly from the audio_url.

Payload and Request Formation

Authorizations

Authorization
string
header
required

Body

multipart/form-data
audio_url
string
required

Input audio URL (supported format: YouTube URL).

Example:

"https://example.com/audio.wav"

voice_id
string
required

The ID of the voice model to use for voice transformation.

Example:

"demo-voice-id"

audio_file
file

Audio file to upload and process. Either audio_file or audio_url must be provided.

pitch
integer
default:0

Pitch adjustment for the voice. Range from -12 to 12. Default: 0

Required range: -12 <= x <= 12
webhook_url
string

A URL where the result will be sent once processing is completed.

Example:

"https://example.com/callback"

Response

Successful response

success
boolean
task_id
string
conversion_id
string
eta
integer