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": "6765cf49-c73a-4fae-985d-806b782ec4f2",
    "text": "Hello there, the weather is really nice today!",
    "promptId": "default",
    "preset": "balance",
    "break_clone": true,
    "language": "auto",
    "vivid": false,
    "emo_switch": [
        0,
        0,
        0,
        0,
        0
    ],
    "speechRate": 1,
    "flash": false,
    "stream": false,
    "seed": -1,
    "srt": false
}

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": "6765cf49-c73a-4fae-985d-806b782ec4f2",
    "text": "Hello there, the weather is really nice today!",
    "promptId": "default",
    "preset": "balance",
    "break_clone": true,
    "language": "auto",
    "vivid": false,
    "emo_switch": [
        0,
        0,
        0,
        0,
        0
    ],
    "speechRate": 1,
    "flash": false,
    "stream": false,
    "seed": -1,
    "srt": false
}'

Responses

🟢200Audio successfully generated

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 points

🟠404Specified model or voice not found

🔴500Internal Server Error

Modified at 2025-11-09 12:11:15

Delete Style of the specified ID for the Voice Character with the specified ID

Create Asynchronous Voice Generation Task