List Cover history

List your AI Cover history records, with a cursor for older records.

GET /sound_clone/sound_clone/api/v1/cover/list

Example Request

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/cover/list' \
--header 'accessKey: xxx'

200（success）

{
    "code": 1,
    "message": "Success",
    "data": {
        "hasMore": false,
        "earliestHistoryItemId": "198",
        "list": [
            {
                "voiceId": "458",
                "voiceName": "QWERTYUIOPASD",
                "id": "203",
                "title": "Beyonce T4",
                "useChars": 2616,
                "channel": "web"
            },
            {
                "voiceId": "452",
                "voiceName": "@#$%^&Z",
                "id": "202",
                "title": "sd",
                "useChars": 2592,
                "channel": "api"
            }
        ]
    }
}

_{AI Cover · History · Workflow: AI Cover quickstart}

Header

accessKey · string · required

Your API key. See Authentication.

Body

limit · number · default: "10"

The number of AI Cover history records returned at one time, supporting 10 ~ 1000 data queries at a time.

If this parameter is empty, the default value is 10.

startBeforeCoverId · string

If this parameter is provided, we will start tracing back to earlier AI Cover history from this AI Cover item.

If this parameter is empty, then we will default to tracing back directly from the most recent data.

Response

code · number · required

Indicates whether the call was successful. 1 if successful.

message · string

When an exception occurs, specific exception information will be provided in the message.

data · object

Includes specific data.

Show Toggle object

hasMore · boolean

If there is no earlier created AI Cover item, then callback 1

If there are still earlier created AI Cover items, then callback 0

earliestHistoryItemId · String

The earliest AI Cover id in this response.

list · list

The AI Cover history records returned by this request.

Show Toggle object

id · string

AI Cover id

title · string

AI Cover title

useChars · number

character count of this AI Cover item.

channel · string

web or api

voiceId · string

The voiceId of the voice used to generate this AI Cover

voiceName · string

The voice name of the voice used to generate this AI Cover.

Example Request

curl --location 'https://api.myvocal.ai/sound_clone/api/v1/cover/list' \
--header 'accessKey: xxx'

200（success）

{
    "code": 1,
    "message": "Success",
    "data": {
        "hasMore": false,
        "earliestHistoryItemId": "198",
        "list": [
            {
                "voiceId": "458",
                "voiceName": "QWERTYUIOPASD",
                "id": "203",
                "title": "Beyonce T4",
                "useChars": 2616,
                "channel": "web"
            },
            {
                "voiceId": "452",
                "voiceName": "@#$%^&Z",
                "id": "202",
                "title": "sd",
                "useChars": 2592,
                "channel": "api"
            }
        ]
    }
}