AI Cover quickstart

AI Cover turns a song into a cover version sung by a chosen voice. It is asynchronous and uses callbacks: the request returns a webhookId immediately, and the result is posted to your callbackUrl when processing ends.

Before you start

An API key; see Authentication.
A public URL that accepts POST requests, to receive callbacks. Keep the same callback URL across related requests. See Cover callbacks.
A voice for the cover: your custom voice’s id or a premade voice’s id. Use List voices to find one. Creating your own Cover voice is optional; see How to use voices.
The song file: mp3 or wav, up to 50 MB.

Step 1: Generate the cover

Send a multipart/form-data request to Generate a cover:

Field	Required	Meaning
`voiceId`	Yes	Your custom voice’s id or a premade voice’s id.
`title`	Yes	Up to 32 characters. If it is empty, the first 32 characters of the target song are used.
`file`	Yes	The target song: mp3/wav, up to 50 MB.
`callbackUrl`	Yes	Where the finished result is posted.

curl --location --request POST 'https://api.myvocal.ai/sound_clone/api/v1/cover' \
--header 'accessKey: <your_api_key>' \
--form 'file=@"xxx/xxx.mp3"' \
--form 'voiceId="111"' \
--form 'title="test"' \
--form 'callbackUrl="http://www.google.com"'

The response returns a webhookId. Store it to match the callback:

{
    "code": 1,
    "message": "Success",
    "data": {
        "webhookId": "7812"
    }
}

Step 2: Receive the callback

When the cover is finished, MyVocal sends a POST to your callbackUrl with webhookType COVER_SONG, the same webhookId, a status of SUCCESS or FAILURE, a summary and, on success, data. Match the callback to your request by webhookId. The payload is described in Cover callbacks.

Step 3: Get the cover audio from Cover History

List your covers to find the record id:
curl --location 'https://api.myvocal.ai/sound_clone/api/v1/cover/list' \ --header 'accessKey: <your_api_key>'
Page further back with limit (10 to 1000, default 10) and startBeforeCoverId. See List Cover history.

Request playable URLs for up to 1,000 ids:

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/cover/query' \
--header 'accessKey: <your_api_key>' \
--header 'Content-Type: application/json' \
--data '{
  "ids":["22","13"]
}'

Each item in data has the record id and its audio url. See Get Cover audio URLs.

To remove records, use Delete Cover history (up to 500 ids per request).

Next steps

Cover callbacks

Callback payload, statuses and samples.

How to use voices

Create or improve your own Cover voice.

Getting started

Text to Speech

Speech to Text

Voice cloning

AI Cover

Text to Music

Interpretation

Integration concepts

Before you start

Step 1: Generate the cover

Step 2: Receive the callback

Step 3: Get the cover audio from Cover History

Next steps

Cover callbacks

How to use voices

​Before you start

​Step 1: Generate the cover

​Step 2: Receive the callback

​Step 3: Get the cover audio from Cover History

​Next steps

Cover callbacks

How to use voices

Before you start

Step 1: Generate the cover

Step 2: Receive the callback

Step 3: Get the cover audio from Cover History

Next steps