本文档由 云音工坊 自动生成，如有疑问，请联系客服微信：yuntts ！
IndexTTS-2高清音质
POST
https://www.yuntts.com/api/v1/text-to-speech
stream_mode 参数控制响应格式：false（默认）→ JSON 响应true → 音频流响应非流式模式（JSON）
请求示例
{
"input": "你好，欢迎使用",
"prompt_audio_url": "https://example.com/voice-sample.wav",
"stream_mode": false
}成功响应
{
"code": 200,
"message": "语音合成成功",
"data": {
"task_id": "tts_sync_67f8a9b0c1d2e",
"status": "completed",
"char_count": 26,
"cost": 0.01,
"mode": "none",
"audio_url": "https://www.yuntts.com/wp-content/uploads/audio/processed/speech-xxx.wav",
"message": "语音合成成功"
}
}| 参数 | 说明 |
|---|---|
task_id | 任务ID |
status | 固定 completed |
char_count | 合成字符数 |
cost | 扣费金额（元） |
mode | 情感模式：audio/text/vector/none |
audio_url | 音频下载链接 |
错误响应
{"code": 402, "error": "insufficient_balance", "message": "余额不足，需要0.01元，当前余额0.00元"}{"code": 500, "error": "save_failed", "message": "音频文件保存失败，已退款"}流式模式（音频流）
请求示例
{
"input": "你好，欢迎使用",
"prompt_audio_url": "https://example.com/voice-sample.wav",
"stream_mode": true
}响应
HTTP/1.1 200 OK
Content-Type: audio/wav
Content-Length: 123456
X-Characters: 26
X-Cost: 0.01
Access-Control-Expose-Headers: X-Characters, X-Cost
[音频二进制数据]| 响应头 | 说明 |
|---|---|
X-Characters | 合成字符数 |
X-Cost | 扣费金额（元） |
前端需读取 X-Characters和X-Cost响应头获取字符数和费用。
前端示例
请求参数
Header 参数
Body 参数application/json必填
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://www.yuntts.com/api/v1/text-to-speech' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
"input": "欢迎使用IndexTTS语音合成系统，这是一个默认模式的示例。",
"prompt_audio_url": "https://www.yuntts.com/tools/tts/1769446289.mp3",
"prompt_text": "欢迎使用语音合成系统。",
"emo_audio_prompt_url": "https://www.yuntts.com/tools/tts/emotion.wav",
"emo_alpha": 0.8,
"use_emo_text": true,
"emo_vector": "[0.5, 0, 0, 0, 0, 0, 0.5, 0]",
"stream_mode": true,
"failover_enabled": false
}'响应示例响应示例
{"code":200,"message":"\u8bed\u97f3\u5408\u6210\u6210\u529f","data":{"task_id":"tts_sync_69e207fee8818","char_count":31,"cost":0,"mode":"none","status":"completed","audio_url":"https:\/\/www.yuntts.com\/wp-content\/uploads\/audio\/processed\/speech-69e207fee8671_1776420862.wav","message":"\u8bed\u97f3\u5408\u6210\u6210\u529f"}}修改于 2026-05-24 17:36:52