Edge TTS语音合成

通过 stream 参数控制响应格式：

false（默认）→ JSON 响应

true → 音频流响应

###非流式模式（JSON）

####请求示例

{
    "text": "你好，欢迎使用语音合成服务",
    "voice": "zh-CN-XiaoxiaoNeural",
    "rate": "+0",
    "pitch": "+0",
    "volume": "+0",
    "stream": false
}

成功响应

{
    "code": 200,
    "message": "合成成功",
    "data": {
        "audio_url": "https://edge.yuntts.com/uploads/audio/xxx.mp3",
        "format": "mp3",
        "char_count": 26
    }
}

参数	说明
`audio_url`	音频下载链接
`format`	音频格式，固定 `mp3`
`char_count`	合成字符数

流式模式（音频流）

请求示例

{
    "text": "你好，欢迎使用语音合成服务",
    "voice": "zh-CN-XiaoxiaoNeural",
    "rate": "+0",
    "pitch": "+0",
    "volume": "+0",
    "stream": true
}

响应

HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Disposition: attachment; filename="tts_audio.mp3"
Transfer-Encoding: chunked

[音频二进制数据]

流式模式直接返回 MP3 音频二进制流，无 JSON 封装。字符数由 char_count 请求参数计算，不通过响应头返回。

前端示例

curl --location 'https://www.yuntts.com/api/v1/edge_tts' \ --header 'Authorization: Bearer {{YOUR_API_KEY}}' \ --header 'Content-Type: application/json' \ --data '{ "text": "欢迎使用Edge TTS语音合成服务，这是一个测试文本。", "voice": "zh-CN-XiaoxiaoNeural", "rate": 5, "pitch": 0, "volume": 10, "stream": true }'

成功响应#

流式模式（音频流）#

请求示例#

响应#

前端示例#

请求参数

返回响应

成功响应

流式模式（音频流）

请求示例

响应

前端示例