Get the list of voice characters for the current user

GET

https://v1.vocu.ai/api/voice

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://v1.vocu.ai/api/voice?from&showMarket' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Successfully retrieved voice character list

application/json

Body

Example

{
    "status": 200,
    "message": "OK",
    "data": [
        {
            "id": "ac68e5c9-25d6-4024-b42e-9777c6277b14",
            "idForGenerate": "bf20083c-b161-46eb-8a7e-d9bc62ea7aaf",
            "name": "Sai Guolan",
            "status": "pending",
            "metadata": {
                "avatar": "https://loremflickr.com/3851/3726?lock=5020255648078239",
                "description": "Armchair enthusiast, graduate",
                "prompts": [
                    {
                        "id": "4dd2f015-1c9d-403e-8ef0-23ca76b8ebad",
                        "name": "Brave",
                        "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/744386/002747-playback-lijo9z.mp3"
                    }
                ]
            }
        },
        {
            "id": "ea6c112a-6c78-4d7d-beda-14cecf9fa85b",
            "idForGenerate": "7f6d050c-b227-4cd8-8b2e-03cd53f7fd5c",
            "name": "Che Ziyan",
            "status": "lora-success",
            "metadata": {
                "avatar": "https://loremflickr.com/1215/2227?lock=5797113421436778",
                "description": "Dreamer, inventor, gourmet",
                "prompts": [
                    {
                        "id": "c6955615-18cb-4189-8207-1e7b06a07c10",
                        "name": "Cold",
                        "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/035564/083043-playback-ozp48y.mp3"
                    },
                    {
                        "id": "a5c925ad-ea35-4d89-ae06-c4e538c617e3",
                        "name": "Bitter",
                        "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/538614/851232-playback-u5biu8.mp3"
                    }
                ]
            }
        }
    ]
}

Modified at 2025-11-09 12:19:18

Add a voice character to the account via a share ID

Get details of the voice character with the specified ID