Synchronous real-time voice generation

POST

https://v1.vocu.ai/api/tts/simple-generate

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Example

{
    "voiceId": "e17dcb66-6418-4391-9992-a7efb6664364",
    "text": "Hello everyone, the weather is really nice today, what do you think?",
    "promptId": "13f59448",
    "preset": "v2_creative",
    "flash": true,
    "stream": true,
    "srt": false,
    "seed": -1,
    "dictionary": []
}

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/simple-generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "voiceId": "e17dcb66-6418-4391-9992-a7efb6664364",
    "text": "Hello everyone, the weather is really nice today, what do you think?",
    "promptId": "13f59448",
    "preset": "v2_creative",
    "flash": true,
    "stream": true,
    "srt": false,
    "seed": -1,
    "dictionary": []
}'

Responses

🟢200Successfully generated audio

application/json

Body

Example

{
    "status": 200,
    "message": "OK",
    "data": {
        "id": "6e2818f1-0817-4425-896b-13fed645a2ce",
        "audio": "https://storage.vocu.ai/generate/f6d422f8-0d1c-4a26-8ee3-a255eb25ebeb/12a2dcfd-9aa8-42b6-bd47-5f6fa3a235cc.mp3",
        "streamUrl": "https://storage.vocu.ai/generate/d590af82-4889-4ef2-91a5-1021022c85b6/stream.mp3?auth=1d105b1b-762a-4e86-8b3c-6c8c2d41b0fe",
        "credit_used": 44
    }
}

🟠400Request parameter error

🟠403Insufficient remaining credits

🟠404Specified model or voice not found

🔴500Internal Server Error

Modified at 2025-08-09 14:17:46

Delete specified ID style of voice character with specified ID

Create asynchronous voice generation task