Qwen-Audio-3.0-TTS-Plus API

通義千問 Audio 3.0 語音合成 Plus 版,按字元計費

POST /v1/audio/speech

qwen-audio-3.0-tts-plus:語音合成,含必填項、巢狀響應和虛構示例。

基础调用

必填参数: model, input

可用参数: model, input, voice, response_format, instructions, speed

请求参数

参数类型必填说明
modelstring是精确型号;仅使用本页名称,不用显示别名替代。 可选: qwen-audio-3.0-tts-plus
inputstring是待合成文本。
voicestring否该型号支持的音色标识。
response_formatstring否输出音频格式。 可选: mp3 / wav
instructionsstring否可选的语气和表达风格说明,支持范围按型号。
speednumber否可选语速倍率,默认1;可用范围按该型号。
## 使用与响应约定 - 必填项与嵌套结构见参数表。未给出数值默认值的可选项,使用该型号当前默认配置。 - 不同型号的上下文、输出预算、素材数量与规格有差异;本页不把未核实的上限写成统一限制。 - 缺失字段与明确的0不同;读取实际返回的状态、内容与用量。 - 示例中的 `example.invalid` 地址必须换成自己有权使用、可被服务读取的素材。 - 生成文件请及时保存;不要假设结果链接永久有效。 ## 参考 参数术语参考[Qwen Speech官方说明](https://www.alibabacloud.com/help/en/model-studio/non-realtime-tts-user-guide);调用时使用本页平台域名和精确型号。文档核对日期:2026-11-07。 ## 完整嵌套字段说明 数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。 ### 请求头 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `Content-Type` | string | 是 | 请求体格式为application/json。 | ### 请求体 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `model` | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选值:qwen-audio-3.0-tts-plus | | `input` | string | 是 | 待合成文本。 | | `voice` | string | 否 | 该型号支持的音色标识。 | | `response_format` | string | 否 | 输出音频格式。 可选值:mp3, wav; 默认:"mp3" | | `instructions` | string | 否 | 可选的语气和表达风格说明,支持范围按型号。 | | `speed` | number | 否 | 可选语速倍率,默认1;可用范围按该型号。 默认:1 | ### 响应 200 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `audio` | file | 否 | 成功响应是音频二进制数据,不是JSON;按Content-Type保存。 | ### 错误响应结构 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `error` | object | 否 | 错误详情;以本次返回为准。 | | `error.message` | string | 否 | 消息内容或可读错误说明,依所在对象区分。 | | `error.type` | string | 否 | 类型标识;依所在对象及枚举取值区分。 | | `error.code` | string | 否 | 错误码,可能为空。 |

请求示例

curl --request POST https://api.router.ai/v1/audio/speech \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "model": "qwen-audio-3.0-tts-plus",
  "input": "Hello. This is a fictional speech example.",
  "voice": "longanlingxin",
  "response_format": "mp3"
}' \
  --output speech.mp3

接口通用说明: 文本轉語音 (千問 TTS)