Vocu Developers
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
Api Docs（Current）User GuideBack To APP
Api Docs（Current）User GuideBack To APP
🇺🇸 English
  • 🇺🇸 English
  • 🇨🇳 简体中文
  1. Voice Character
  • Overview
  • Authentication Method
  • Voice Character
    • Create a new voice character
      POST
    • Add a style to the voice character with the specified ID
      POST
    • Upload avatar for the voice character with the specified ID
      POST
    • Add a voice character to the account via a share ID
      POST
    • Get the list of voice characters for the current user
      GET
    • Get details of the voice character with the specified ID
      GET
    • Get the one-time share link ID for the specified voice character ID
      GET
    • Delete Voice Character with the specified ID
      DELETE
    • Delete Style of the specified ID for the Voice Character with the specified ID
      DELETE
  • Voice Generation
    • Synchronous real-time voice generation
      POST
    • Create Asynchronous Voice Generation Task
      POST
    • Get the list of asynchronous generation tasks for the current user
      GET
    • Get the details of an asynchronous generation task by ID
      GET
    • Delete an asynchronous generation task by ID
      DELETE
  • User Account
    • Get current user account information
      GET
  • Content Template
    • Create New Template
      POST
    • Update Template with Specified ID
      POST
    • Get User's Template List
      GET
    • Get Template Details with Specified ID
      GET
    • Delete Template with Specified ID
      DELETE
  1. Voice Character

Get details of the voice character with the specified ID

GET
https://v1.vocu.ai/api/voice/{id}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://v1.vocu.ai/api/voice/' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Successfully retrieved voice character details
application/json
Body

Example
{
    "status": 200,
    "message": "OK",
    "data": {
        "id": "9f011950-f143-4eb7-abbb-90e0b66874ea",
        "idForGenerate": "53dfa5aa-93e8-40b5-a5ea-2055ce885012",
        "name": "Zhen Xia",
        "status": "lora-success",
        "metadata": {
            "avatar": "https://loremflickr.com/3764/3840?lock=5788646566085736",
            "description": "A great coach",
            "prompts": [
                {
                    "id": "66c052e8-d395-42f1-bb81-dc7325d56430",
                    "name": "Relaxed",
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/253308/726038-playback-xluat9.mp3",
                    "description": "Relaxed emotional style"
                },
                {
                    "id": "3fb2c923-7dd1-459a-9cc2-67b3a8dd3d9e",
                    "name": "Happy",
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/047156/753432-playback-9z7f93.mp3",
                    "description": "Happy emotional style"
                },
                {
                    "id": "b98c3886-6581-4674-8145-2ce20ef1b72c",
                    "name": "Brave",
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/425833/754481-playback-iiejro.mp3",
                    "description": "Brave emotional style"
                }
            ]
        }
    }
}
🟠404Voice character with the specified ID not found
Modified at 2025-11-09 12:11:15
Previous
Get the list of voice characters for the current user
Next
Get the one-time share link ID for the specified voice character ID