同步实时生成语音 - Vocu AI 开发者文档

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

voiceId

string

语音角色 ID

必需

text

string

要生成的文本内容

必需

texts

array[string]

可选

要生成的文本列表，优先级高于text参数

promptId

string

可选

角色风格 ID（默认为default)

默认值:

default

preset

enum<string>

可选

参数预设，默认为v2_creative

枚举值:

v2_creativev2_balancev2_stable

默认值:

v2_creative

randomness

integer

可选

多样性 (0-100，默认为100，填写后将覆盖参数预设中的对应值)

>= 0<= 100

默认值:

100

stability_boost

integer

可选

稳定性过滤 (0-1024，默认为1024，填写后将覆盖参数预设中的对应值)

>= 0<= 1024

默认值:

1024

probability_optimization

integer

可选

概率优选（0-100，默认为100，填写后将覆盖参数预设中的对应值）

>= 0<= 100

默认值:

100

break_clone

boolean

可选

启用偏向文本的情感风格（默认为true，填写后将覆盖参数预设中的对应值）

默认值:

true

sharpen

boolean

可选

音质增强（实验性，默认为false，填写后将覆盖参数预设中的对应值）

默认值:

false

flash

boolean

可选

低延迟模式（默认为false）

默认值:

false

stream

boolean

可选

是否启用流式生成（默认为false)

默认值:

false

srt

boolean

可选

是否启用字幕生成（与低延迟模式不兼容，默认为false）

默认值:

false

seed

integer <int32> | null

可选

生成种子，最大为Int32，-1或null时为随机（默认为-1）

>= -1

默认值:

-1

dictionary

array [object]

可选

读音字典，格式为：[ ["音素", [["y", "in1"],["s" "u4"]]], ["你好", [["n", "i3"],["h" "ao3"]]]]

示例

{
    "voiceId": "e17dcb66-6418-4391-9992-a7efb6664364",
    "text": "大家好啊，今天的天气真不错啊，你觉得呢？",
    "promptId": "13f59448",
    "preset": "v2_creative",
    "flash": true,
    "stream": true,
    "srt": false,
    "seed": -1,
    "dictionary": []
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://v1.vocu.ai/api/tts/simple-generate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "voiceId": "e17dcb66-6418-4391-9992-a7efb6664364",
    "text": "大家好啊，今天的天气真不错啊，你觉得呢？",
    "promptId": "13f59448",
    "preset": "v2_creative",
    "flash": true,
    "stream": true,
    "srt": false,
    "seed": -1,
    "dictionary": []
}'

返回响应

🟢200成功生成音频

application/json

Body

status

integer

状态码

必需

示例值:

200

message

string

状态信息

必需

示例值:

OK

data

object

生成的音频详情

必需

id

string

生成的音频 ID

必需

audio

string

必需

最终生成的音频 URL

streamUrl

string

可选

流式生成的MP3端点

credit_used

integer

消耗的点数

必需

示例

{
    "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服务器内部错误