Skip to main content
POST

授权

Authorization
string
header
必填

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

请求体

application/json

使用平台标准 model、字符串 input 和 voice 调用 Qwen3-TTS,固定返回 WAV 音频。语言可放入 extra_body 或顶层,同名字段顶层优先。

model
string
必填

网关已配置的 Qwen3-TTS-Flash 模型 ID 或别名。

Minimum string length: 1
示例:

"qwen3-tts-flash"

"bailian/qwen3-tts-flash"

input
string
必填

需要合成的朗读文本,最多 600 字符,支持多语种混合输入。

Required string length: 1 - 600
示例:

"你好,欢迎测试语音合成接口。"

voice
string
必填

填写 Qwen3-TTS 支持的预置音色,区分大小写;完整清单见 Qwen 音色指南。

Minimum string length: 1
示例:

"Cherry"

"Serena"

"Ethan"

response_format
enum<string>
默认值:wav

Qwen3-TTS 固定返回 WAV;省略时使用 WAV。

可用选项:
wav
stream_format
enum<string>
默认值:audio

audio 返回 WAV 音频字节;sse 返回网关统一的 speech.audio.delta 和 speech.audio.done 事件,音频分片为 Base64。

可用选项:
audio,
sse
extra_body
object

供应商扩展参数。字段直接放入此对象,无须嵌套原生 input 或 parameters。

language_type
enum<string>

兼容顶层扩展写法;与 extra_body.language_type 同时存在时,以此字段为准。通常只需选择一种位置传入。

可用选项:
Auto,
Chinese,
English,
German,
Italian,
Portuguese,
Spanish,
Japanese,
Korean,
French,
Russian

响应

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

The response is of type string.