同步实时生成语音

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": "大家好啊，今天的天气真不错啊，你觉得呢？",
    "promptId": "13f59448",
    "preset": "balance",
    "flash": false,
    "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": "大家好啊，今天的天气真不错啊，你觉得呢？",
    "promptId": "13f59448",
    "preset": "balance",
    "flash": false,
    "stream": true,
    "srt": false,
    "seed": -1,
    "dictionary": []
}'

Responses

🟢200成功生成音频

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
    }
}

🟠400请求参数错误

🟠403剩余点数不足

🟠404未找到指定的模型或语音

🔴500服务器内部错误

Modified at 2025-09-07 16:21:11

删除指定 ID 的语音角色的指定 ID 风格

创建异步语音生成任务