简易流式生成语音 - Vocu AI 开发者文档

此API可直接作为流式mp3音频进行请求并播放。
该API也可通过 /api/tts/simple-generate.mp3 访问

请求参数

Query 参数

token

string

必需

API Key(该接口可通过该参数传递API Key以在简单请求中使用)

voiceId

string

语音角色 ID

必需

text

string

要生成的文本内容

必需

promptId

string

可选

角色风格 ID（默认为default)

默认值:

default

flash

boolean

可选

低延迟模式（默认为false）

默认值:

false

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

seed

integer <int32> | null

可选

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

>= -1

默认值:

-1

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功生成音频

application/octet-stream

Body

status

integer

状态码

必需

示例值:

200

message

string

状态信息

必需

示例值:

data

object

生成的音频详情

必需

string

生成的音频 ID

必需

audio

string

必需

生成的音频 URL（若启用origin_audio则为包含音频Base64的Data URL）

streamUrl

string

流式MP3端点

可选

credit_used

integer

消耗的点数

必需

示例

// 该接口成功时响应为mp3 chunked流
// 可从响应标头中读取 X-Reecho-Audio-Id 以及 X-Reecho-Response-Data, 其中包含的URL可在数小时内重复拉流, 也可从中读取类似 credit_used 的返回数据

🟠400请求参数错误

🟠403剩余点数不足

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

🔴500服务器内部错误