Skip to main content
POST

授权

Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>

请求头

X-DashScope-SSE
enum<string>

阿里官方 HTTP 流式开关。传 enable 时返回 text/event-stream

可用选项:
enable

请求体

application/json
model
enum<string>
必填

模型名称,可用选项:qwen3-tts-instruct-flash

可用选项:
qwen3-tts-instruct-flash
input
string
必填

要合成的文本。该字段支持多语种输入。

voice
enum<string>
必填

使用的音色。参见支持的系统音色。

可用选项:
Cherry,
Serena,
Ethan,
Chelsie,
Momo,
Vivian,
Moon,
Maia,
Kai,
Nofish,
Bella,
Eldric Sage,
Mia,
Mochi,
Bellona,
Vincent,
Bunny,
Neil,
Elias,
Arthur,
Nini,
Seren,
Pip,
Stella
instructions
string

设置指令,参见指令控制。

默认值:无,不设置时不生效。 最大长度:1600 Token。 支持语言:仅支持中文和英文。 适用范围:该功能仅适用于千问3-TTS-Instruct-Flash-Realtime 系列模型。

optimize_instructions
boolean

instructions 进行语义优化,以提升语音合成的自然度和表现力。

默认值:false。 行为说明:当设置为 true 时,系统将对 instructions 的内容进行语义增强与重写,生成更适合语音合成的内部指令。 推荐在追求高品质、精细化语音表达时开启。 依赖 instructions 参数。若 instructions 为空,此参数不生效。 适用范围:该功能仅适用于千问3-TTS-Instruct-Flash 系列模型。

language_type
enum<string>

合成音频的语种。默认为 Auto

  • Auto:适用于文本包含多种语言或语种不确定的场景。模型自动为不同语言片段匹配发音,但无法保证完全精准。
  • 指定语种:适用于单一语种文本。指定具体语种能显著提升合成质量,效果通常优于 Auto
可用选项:
Auto,
Chinese,
English,
German,
Italian,
Portuguese,
Spanish,
Japanese,
Korean,
French,
Russian

响应

调用成功。非流式时返回阿里官方 JSON;流式时返回阿里 SSE 数据。

status_code
integer

HTTP 状态码。遵循 RFC 9110 标准定义。例如:

  • 200:请求成功,正常返回结果
  • 400:客户端请求参数错误
  • 401:未授权访问
  • 404:资源未找到
  • 500:服务器内部错误
request_id
string

本次请求的唯一标识,可用于问题排查。

code
string

请求失败时展示的错误码。

message
string

请求失败时展示的错误信息。

output
object

模型的输出。

usage
object

本次请求的 Token 或字符消耗信息。千问-TTS 模型返回 Token 消耗信息,千问3-TTS-Flash 模型返回字符消耗信息。