苏州话 AI 配音 API
Wu-Chinese (Suzhounese) Text-to-Speech · 稀缺方言音色,非普通话合成
9 种音色
公网可直连
返回 WAV 音频流
零 SDK 依赖
在线试听
直接调真实 API,输入任意中文,听苏州话合成效果。公开试用 Key 已内置。
实测性能
以下为 2026-09-02 经公网链路实测,非理论值。
| 输入 | 分句数 | 推理耗时 | 音频时长 | 结果 |
| 9 字短句 | 1 | 5~7s | ~3s | 200 WAV |
| 25 字 | 3 | 14.4s | ~7s | 200 WAV |
| 50 字 | 6 | 29.1s | ~11s | 200 WAV |
| 73 字 | 9 | 36.3s | 14.4s | 200 WAV |
选型提示:每句固定开销约 3~4 秒,长文本按句累加,属非实时合成。
适合预先生成音频文件的场景(门店广播、短视频配音、有声内容批量生产),
不适合电话客服等需要毫秒级响应的实时流式场景。
快速开始
curl
curl -X POST https://wuyu-tts.pages.dev/v1/tts \
-H "Content-Type: application/json" \
-H "X-API-Key: demo_public" \
-d '{"text":"欢迎光临","voice":"baidu_gold_b"}' \
--output out.wav
Python
import requests
r = requests.post(
"https://wuyu-tts.pages.dev/v1/tts",
headers={"X-API-Key": "demo_public"},
json={"text": "欢迎光临", "voice": "baidu_gold_b"},
timeout=180)
open("out.wav", "wb").write(r.content)
print(r.headers["X-Audio-Duration"], "秒")
JavaScript
const r = await fetch(
"https://wuyu-tts.pages.dev/v1/tts", {
method: "POST",
headers: {"Content-Type":"application/json",
"X-API-Key":"demo_public"},
body: JSON.stringify({text: "欢迎光临", voice: "baidu_gold_b"})
});
const url = URL.createObjectURL(await r.blob());
new Audio(url).play();
接口说明
| 项 | 值 |
| Endpoint | POST /v1/tts |
| 鉴权 | 请求头 X-API-Key |
| 响应 | audio/wav 二进制流(成功)/ JSON(失败) |
| 单次文本上限 | 500 字 |
| CORS | 已开放(Access-Control-Allow-Origin: *) |
请求参数
| 字段 | 类型 | 默认 | 说明 |
text | string | — | 必填,待合成文本 |
voice | string | baidu_gold_b | 音色名,见下表 |
speed | float | 0.95 | 语速 |
auto_split | bool | true | 长文本自动分句(>20 字生效),关闭则整段合成 |
响应头(成功时)
| 头 | 说明 |
X-Audio-Duration | 音频时长(秒) |
X-Chars | 实际合成字数 |
X-Split-Parts | 分句数量 |
X-Elapsed | 服务端耗时(秒) |
X-Request-Id | 请求 ID,排查用 |
音色列表
| 音色 | 特点 |
| baidu_gold_b | 女声播报 · 默认,门店广播常用 |
| baidu_gold_a | 女声播报 A |
| wuzixu_nat2 | 自然女声,口语感强 |
| wuzixu | 男声 |
| wuzixu_nat | 自然男声 |
| wuzixu_casual | 男声口语 |
| suzhou_girl | 苏州女声 |
| suzhou_std | 苏州标准音 |
| girl | 通用女声 |
错误码
| 码 | 含义 |
| 401 | 缺少或无效的 X-API-Key |
| 403 | Key 已被停用 |
| 400 | text 为空或参数非法 |
| 429 | 超出限流(公开试用 30 次/分钟、1000 次/天) |
关于公网地址:当前域名由 Cloudflare 临时隧道提供,用于试用与联调;
正式商用建议改为固定域名(自有域名 + 固定隧道或反向代理)。音频质量与音色不受影响。