Skip to main content
POST
/
v1
/
Cover
Convert audio to cover song
curl --request POST \
  --url https://api.musicgpt.com/api/public/v1/Cover \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form audio_url=https://example.com/audio.wav \
  --form voice_id=demo-voice-id \
  --form 'audio_file=<string>' \
  --form pitch=0 \
  --form webhook_url=https://example.com/callback \
  --form 0.audio_file='@example-file' \
  --form 1.audio_file='@example-file'
{
  "success": true,
  "task_id": "b329c0df-b2eb-4914-b707-4d7dce53577e",
  "conversion_id": "16708396-da86-4a9e-9b90-66f774cc2382",
  "eta": 33
}

Documentation Index

Fetch the complete documentation index at: https://docs.musicgpt.com/llms.txt

Use this file to discover all available pages before exploring further.

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

POST /Cover
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

ParameterTypeRequiredDescription
audio_urlStringOptionalURL of the audio file to convert. Either audio_url or audio_file must be provided.
audio_fileUploadFileOptionalUpload the audio file directly. Either audio_url or audio_file must be provided.
voice_idStringYesVoice model to convert the audio into.
pitchIntegerOptionalAdjust pitch between -12 and 12 semitones. Default is 0.
webhook_urlStringOptionalCallback URL for async response.
💡Note: You must provide either audio_url or audio_file — not both as None.
content-type: multipart/form-data

​
Sample Request

​
cURL

curl -X POST "https://api.musicgpt.com/api/public/v1/Cover" \
-H "accept: multipart/form-data" \
-H "Authorization: <api_key>" \
-F "audio_url=https://www.youtube.com/watch?v=jGflUbPQfW8" \
-F "voice_id=Drake" \
-F "pitch=0" \
-F "webhook_url=http://webhook.musicgpt.com"

​
Python

import requests

url = "https://api.musicgpt.com/api/public/v1/Cover"
headers = {
    "accept": "multipart/form-data",
    "Authorization": "<api_key>"
}

input_audio_file = open("{path_to_your_audio_file}", "rb")
payload = {
    "audio_url": "",
    "voice_id": "Drake",
    "pitch": 0,
    "webhook_url": "http://abc.requestcatcher.com/test",
}

response = requests.post(url, headers=headers, data=payload, files={"audio_file": input_audio_file})
print(response.json())
Replace {path_to_your_audio_file}, api_key, and webhook_url before executing.

​
Sample Response

​
Success (200 OK)

{
  "success": true,
  "task_id": "3d137437-4911-4669-b639-9e5701107c25",
  "conversion_id": "b764b4f6-a842-42dd-a55b-818eb8251dc7",
  "eta": 71,
  "credit_estimate": 1.27,
  "message": "Message published to queue",
  "status": "IN_QUEUE"
}

​
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: 
{
  "success": true,
  "conversion_type": "Cover",
  "task_id": "0ec93bdd-6132-40db-a873-676dc314919c",
  "conversion_id": "acff300f-1c96-498d-99fe-929b985c5c55",
  "audio_url": "https://lalals.s3.amazonaws.com/projects/acff300f-1c96-498d-99fe-929b985c5c55.mp3",
  "audio_url_wav": "https://lalals.s3.amazonaws.com/projects/acff300f-1c96-498d-99fe-929b985c5c55.wav",
  "conversion_cost": "0.88",
  "conversion_duration": 272.44
}
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

URL of an audio file to process. Either audio_url or audio_file must be provided.

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