Create new voice character

POST

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

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Example

{
    "name": "Huan Wei",
    "prompt": "data:audio/wav;base64,tpjNbeTKpxXh1md3KTHnzOzJrqU7Wfh55IpoUdWBry0WeQ3NfWCvKtrP7W1HZkBgX2hyoyrG5VFGfFho660B6dewFmskNRhURfgBsdIFVwIQfRv7GWGfbOElPGoOlLPwD24BMnfrYuo6ttT43LHdkbI2oteg2p7HVI4a6CGXNuwiKGz2wAGqvUGWLd4etPerSlyZAnyEBjae9zUl0NmKMs2OsChVWSVXU1PRCojKczpTuT0BgRdiaifCOKebnfEreYooba7MdqP0gbppfz6Xaz4tEuTJ1p7iKI7VDzn0ERWWCsGaOCsjGsidHgs6RVcXCKdVDB8CTenn2KyaL1aBv2WeASeOFMF5jgOw5mcHgmVA87eDQUaAHepsfHvR5OrlbkmGB306wR08wlxxI6IMHXKo74BHZDQSretnxRFxcD37ExfXAzUQ5e7o15WCdXe5hay5RIU7Dsp9wfHiV6TT5SxiT0ap4ta3fSegZXG5rlmKfJhJieUP",
    "modelVersion": "v2.1",
    "description": "A very excellent coach",
    "avatar": "data:image/png;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIyMjQ3IiBoZWlnaHQ9IjMwNTUiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNhMWUzYjUiLz48dGV4dCB4PSIxMTIzLjUiIHk9IjE1MjcuNSIgZm9udC1zaXplPSIyMCIgYWxpZ25tZW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZpbGw9IndoaXRlIj4yMjQ3eDMwNTU8L3RleHQ+PC9zdmc+",
    "enhance": false,
    "lora": "de4bcda7-5b65-4747-b74a-d03429457fe6"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://v1.vocu.ai/api/tts/voice' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Huan Wei",
    "prompt": "data:audio/wav;base64,tpjNbeTKpxXh1md3KTHnzOzJrqU7Wfh55IpoUdWBry0WeQ3NfWCvKtrP7W1HZkBgX2hyoyrG5VFGfFho660B6dewFmskNRhURfgBsdIFVwIQfRv7GWGfbOElPGoOlLPwD24BMnfrYuo6ttT43LHdkbI2oteg2p7HVI4a6CGXNuwiKGz2wAGqvUGWLd4etPerSlyZAnyEBjae9zUl0NmKMs2OsChVWSVXU1PRCojKczpTuT0BgRdiaifCOKebnfEreYooba7MdqP0gbppfz6Xaz4tEuTJ1p7iKI7VDzn0ERWWCsGaOCsjGsidHgs6RVcXCKdVDB8CTenn2KyaL1aBv2WeASeOFMF5jgOw5mcHgmVA87eDQUaAHepsfHvR5OrlbkmGB306wR08wlxxI6IMHXKo74BHZDQSretnxRFxcD37ExfXAzUQ5e7o15WCdXe5hay5RIU7Dsp9wfHiV6TT5SxiT0ap4ta3fSegZXG5rlmKfJhJieUP",
    "modelVersion": "v2.1",
    "description": "A very excellent coach",
    "avatar": "data:image/png;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIyMjQ3IiBoZWlnaHQ9IjMwNTUiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNhMWUzYjUiLz48dGV4dCB4PSIxMTIzLjUiIHk9IjE1MjcuNSIgZm9udC1zaXplPSIyMCIgYWxpZ25tZW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZpbGw9IndoaXRlIj4yMjQ3eDMwNTU8L3RleHQ+PC9zdmc+",
    "enhance": false,
    "lora": "de4bcda7-5b65-4747-b74a-d03429457fe6"
}'

Responses

🟢200Successfully created voice character

application/json

Body

Example

{
    "status": 200,
    "message": "OK",
    "data": {
        "id": "e4296465-a999-4869-b103-09dc4506bdf1",
        "idForGenerate": "894b9cf3-d0dc-41c9-91dc-2b4947f588d6",
        "name": "Huan Wei",
        "status": "pending",
        "metadata": {
            "avatar": "https://loremflickr.com/1688/727?lock=1030955216131236",
            "description": "A very excellent coach",
            "prompts": [
                {
                    "id": "default",
                    "name": "Default Style",
                    "promptOriginAudioStorageUrl": "https://storage.vocu.ai/prompt/062326/734689-playback-kg1wvu.mp3"
                }
            ]
        }
    }
}

🟠400Request parameter error

🟠403No permission to perform this operation

🔴500Internal Server Error

Modified at 2025-08-09 14:13:01

Low latency WebSocket real-time generation

Add style to voice character with specified ID