ChindaTTS 文字转语音
以三种音色之一、八种说话风格之一,或从短音频克隆的音色,朗读泰文或泰英混合文本,返回 48 kHz 的 WAV 或 MP3 文件。
Alpha
服务处于 Alpha 阶段,可能间歇性不可用。
- 价格1 IC每 400 字符
- 累计调用2.1M次
输入
- text
- สวัสดีค่ะ ยินดีต้อนรับค่ะ
- voice
- kaimook
- style
- friendly
- format
- mp3
输出POST /v3/store/audio/tts
HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-Sample-Rate: 48000
<MP3 audio, mono, 48 kHz>全部字段见“响应”一节其他端点:/clone 见请求
请求
以所选音色朗读使用 JSON,克隆声音使用 multipart/form-data。每个端点均按每 400 字符文本 1 IC 计费。
| 端点 | 返回 |
|---|---|
POST /v3/store/audio/tts | 以所选音色与风格朗读的 48 kHz WAV 或 MP3 文件 |
POST /v3/store/audio/tts/clone | 以上传片段的声音朗读的 48 kHz WAV 或 MP3 文件 |
旧路径 /v3/store/audio/tts/tts 与 /v3/store/audio/tts/tts/clone 指向同样这两个端点。
请求头
apikeystring必填您的 API 密钥,在控制台的 API Keys 中创建。
请求体
textstring必填要朗读的文本,最多 1,200 字符(
/clone 最多 1,000 字符),约 100 秒音频。更长的文本请在句末拆分,分次发送。voicestringdefault:kaitomstylestringdefault:neutralneutral、friendly、cheerful、calm、serious、sad、excited 或 empathetic。风格改变语气,不改变音色;其他取值会以 400 拒绝。formatstringdefault:wavwav 或 mp3。filefile仅
/clone,且为必填:同一说话人 10 至 20 秒的干净语音,WAV 或 MP3,最大 20 MB。过短或有噪音的片段会以 400 拒绝。consentboolean仅
/clone,且为必填:true,确认该声音属于您或说话人已同意。缺少时请求会以 400 拒绝。denoisebooleandefault:false仅
/clone:使用前先去除片段中的背景噪音。响应
请求头
Content-Typestringaudio/wav;format 为 mp3 时为 audio/mpeg。X-Sample-Ratestring48000。请求体
audiobinary可直接播放或保存的音频:WAV 文件(16 位,单声道,48 kHz)或 MP3。克隆的返回方式相同。
状态码
| 代码 | 含义 |
|---|---|
| 400 | JSON 格式错误、文本中没有可朗读的内容,或风格未知;/clone 还包括未确认同意,或片段过短、噪音过大 |
| 413 | 文本超过 1,200 字符,或片段超过 20 MB |
| 429 | 请求超过该密钥的限额;稍候再试 |
| 503 | 服务繁忙;稍后重试 |
详情
音色与风格
| 音色 | voice | 适合 |
|---|---|---|
| Kaitom,默认 | kaitom | 男声,适用于各种场景 |
| Kaimook | kaimook | 女声,明亮亲切:客服、迎宾 |
| Kaidang | kaidang | 男声:播报、语音助手 |
style | 听感 | 用于 |
|---|---|---|
neutral,默认 | 平实、均衡 | 信息播报 |
friendly | 温暖、轻松 | 聊天、客服、迎宾 |
cheerful | 明亮、欢快 | 促销、好消息 |
calm | 缓慢、柔和、舒缓 | 引导、安抚 |
serious | 坚定、沉稳 | 警示、公告、条款 |
sad | 缓慢、轻柔、低沉 | 慰问、致歉 |
excited | 快速、有活力 | 庆祝 |
empathetic | 温柔、关怀 | 敏感话题的支持 |
每种音色都支持全部风格;全部 24 种组合可在 ChindaTTS 页面试听。文本按原样朗读,因此给 Kaimook 的文本请在 Kaitom 和 Kaidang 说 ครับ 的位置写 ค่ะ 或 คะ。
实测
将生成的音频转写回文本时的字符错误率,越低越好。
| 文本 | 字符错误率 |
|---|---|
| 日常泰语 | 3.2% |
| 数字、日期、货币 | 1.4% |
| 泰英混合 | 7.6% |
| 带情绪的风格 | 3.9% |
100 字符的请求约需 1.5 秒,1,000 字符约需 14 秒。
限制
- 支持泰语和英语;其他文字、表情符号和符号会被去掉,不会读出。克隆仅支持泰语。
- 每次请求最多 1,200 字符(
/clone最多 1,000),约 100 秒音频。 - 每个 API 密钥每秒 100 次请求。
- 标点决定停顿。若需特定发音,请将品牌名或缩写转写为泰文:用
ไอแอป而非iApp。
数据处理
文本和参考音频在内存中处理,响应返回后不保留。依 PDPA 与 GDPR 取得同意并告知当事人,由作为数据控制者的您负责。
已弃用的端点
V1 和 V2 端点仍可调用,价格不变,但不再维护。请改用 /v3/store/audio/tts。
| 端点 | 原为 |
|---|---|
/v3/store/speech/text-to-speech/kaitom,另有 /thai-tts-kaitom2/tts | V2,Kaitom 音色 |
/v3/store/speech/text-to-speech/kaitom/v1,另有 /thai-tts-kaitom/tts | V1,Kaitom 音色 |
/v3/store/speech/text-to-speech/cee,另有 /thai-tts-cee/tts | V1,Cee 音色 |
迁移时,改为发送含 text 的 JSON,按需加上 voice、style 和 format,不再使用表单字段或查询字符串,并去掉 language:语言会自动检测。返回的是可直接播放的音频文件。已不再提供 Cee 音色。
更新日志
| 版本 | 变更 |
|---|---|
| ChindaTTS,2026 年 10 月 | 三种音色(voice:kaitom、kaimook、kaidang)、八种说话风格(style),以及 WAV 或 MP3 可选(format)。响应改为音频文件:48 kHz 的 WAV 或 MP3,取代 24 kHz 原始 PCM,可直接播放或保存,无需再加 WAV 头。克隆支持 style、format 与 denoise。 |
| ChindaTTS | V3 端点改由 ChindaTTS 提供,请求与响应不变,每次请求最多 1,200 字符。V1 和 V2 端点已弃用,见已弃用的端点。 |
| V3 | 端点由 /v3/store/speech/text-to-speech/kaitom 改为 /v3/store/audio/tts,采用 JSON 请求体,自动检测语言而无需 language 模式,最多 10,000 字符,24 kHz 输出,对数字、日期、货币、时间和百分比做文本规范化,并支持声音克隆。 |