Skip to main content
POST

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

沿用平台标准语音字段;Google 扩展仅保留 language_code,支持 extra_body 和顶层两种写法,顶层同名字段优先。

model
string
必填

平台已配置的 Google TTS 模型 ID 或别名。文档中的 models/ 前缀来自 Google 模型目录,平台示例使用 google/ 前缀。

Minimum string length: 1
示例:

"google/gemini-3.8-flash-tts"

"google/gemini-3.8-flash-lite-tts"

"google/gemini-3.1-flash-tts-preview"

input
string
必填

待朗读文本。4096 字符是当前网关统一请求的限制,不等于 Google 上游的 Token 上下文长度。

Required string length: 1 - 4096
示例:

"你好,欢迎使用语音合成。"

voice
必填

当前模型可用的预置音色名称或音色 ID,也接受包含 id 的对象。3.1/2.5 使用对应的通用预置音色;3.8 可引用项目可用的扩展或自定义 ID。

Minimum string length: 1
示例:

"Kore"

instructions
string

统一风格指令。3.8 将风格与朗读正文分开处理;2.5/3.1 使用旧版提示文本。

Maximum string length: 4096
response_format
enum<string>
默认值:wav

当前 Google 适配仅支持 WAV/PCM。wav 返回带容器头的音频;pcm 返回无文件头的 16 位线性 PCM。采样率沿用上游音频,不能仅凭此字段指定。

可用选项:
wav,
pcm
speed
number
默认值:1

网关统一语速参数,范围沿用标准协议。Google 通过自然语言风格提示实现,属于近似控制,不保证精确倍速或固定音频时长。

必填范围: 0.25 <= x <= 4
stream_format
enum<string>
默认值:audio

audio 返回音频字节;sse 返回统一 speech.audio.delta / speech.audio.done 事件。当前 Google 适配先接收完整合成结果再输出 SSE,不代表已启用上游低延迟流式合成。

可用选项:
audio,
sse
extra_body
object

Google 专有扩展;推荐放在这里。也兼容同名字段直接放在 body 顶层,顶层优先,仅展开一层,不对嵌套对象做深度合并。

language_code
string

兼容顶层扩展;优先于 extra_body 中同名字段。Google 语言提示,使用 BCP-47 代码,如 cmn-CN、en-US。支持范围由模型决定;不从音色试听的 en-US 标签推断。

Minimum string length: 1

响应

音频字节或统一 SSE 音频事件;支持的媒体类型见下方列表。

The response is of type string.