本文档由云音工坊自动生成，如有疑问，请联系客服微信：yuntts ！

语音合成（Qwen-Audio-TTS）

POST

/api/v1/qwen-audio-synthesize

Qwen-Audio-TTS 非实时语音合成，支持非流式与流式（stream=true 时返回 SSE）。

适用模型：qwen-audio-3.1-tts-flash / qwen-audio-3.0-tts-plus / qwen-audio-3.0-tts-flash。

指令参数：instruction（单数）；系统音色与复刻音色均可输入任意指令。

支持在 text 中直接嵌入情感/富语言标签（如 [sad]、[laughing]），服务端原样透传、不做校验。

流式说明：中间分片 output.audio.data 为 Base64 音频片段，最后一片 output.audio.url 为完整音频地址（有效期 24 小时）。

计费字符口径：汉字按 2 计，其余按 1 计；启用 SSML 时标签本身不计费。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "model": "qwen-audio-3.0-tts-flash",
    "voice": "longanhuan_v3.6",
    "text": "[excited]今天的天气真不错！[laughing]我们一起出去玩吧！",
    "instruction": "请用河南话表达。",
    "format": "wav",
    "sample_rate": 24000,
    "stream": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/qwen-audio-synthesize' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "qwen-audio-3.0-tts-flash",
    "voice": "longanhuan_v3.6",
    "text": "[excited]今天的天气真不错！[laughing]我们一起出去玩吧！",
    "instruction": "请用河南话表达。",
    "format": "wav",
    "sample_rate": 24000,
    "stream": false
}'

返回响应

🟢200

application/json

非流式返回 JSON；流式返回 text/event-stream

Bodyapplication/json

示例

{
    "code": 200,
    "message": "语音合成成功",
    "data": {
        "finish_reason": "stop",
        "audio": {
            "data": "",
            "url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/pre/qwen-audio-3.0-tts-flash/20260304/xxx/xxx.wav?...",
            "id": "audio_ee88b03d-0457-9286-8c67-xxxxxxxxxxxx",
            "expires_at": 1772697707
        }
    },
    "char_count": 15,
    "cost": 0
}

修改于 2026-10-14 06:24:56

删除自定义音色

创建音色（Qwen-Audio-TTS：复刻 / 设计）