加载接口文档…
5K
累计调用
1106ms
平均响应
97.88%
服务可用性
30 次/日
免费额度
访问限制
查看更多方案 →
文档链接
复制文档地址
https://apizero.cn/aidocs/tts/raw.md接口请求地址
https://v1.apizero.cn/api/tts
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/tts
接口信息备注
匿名每日 10 次、QPS 1；登录用户每日 30 次、QPS 3（全部免费）。本接口不缓存，每次请求都会调用服务。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| text | string | 必填 · 待合成文本，1-500 字符（中英文均按 1 字符计） · 示例：欢迎使用语音合成服务 |
| voice_type | string | 可选 · 音色代码。可选：female_zhubo（女声主播） / male_zhubo（男声主播） / male_rap（男声说唱） / female_sichuan（女声四川话） / male_db（男声低沉）。默认 female_zhubo · 示例：female_zhubo |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
| Content-Type | string | 可选 · 支持 application/x-www-form-urlencoded 或 application/json |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| text | string | 回传待合成文本 |
| text_length | number | 文本字符长度 |
| voice_type | string | 音色代码（如 female_zhubo） |
| voice_name | string | 音色中文名（如 女声主播） |
| voice_desc | string | 音色描述（适用场景介绍） |
| audio | string | base64 编码的 MP3 音频（不含前缀）；典型 500 字音频约 1MB |
| audio_format | string | 音频格式，固定 mp3 |
| audio_mime | string | 音频 MIME 类型，固定 audio/mpeg |
| audio_size_bytes | number | 音频解码后字节数（用于估算大小） |
| audio_data_url | string | 拼好的 data URL：data:audio/mpeg;base64,xxx，可直接 <audio src> 播放 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"text": "欢迎使用语音合成服务",
"text_length": 10,
"voice_type": "female_zhubo",
"voice_name": "女声主播",
"voice_desc": "标准普通话女声，主播风格，适合资讯播报",
"audio": "SUQzAwAAAAAAAAAAAAAAA...（约 17000 字符 base64）",
"audio_format": "mp3",
"audio_mime": "audio/mpeg",
"audio_size_bytes": 12750,
"audio_data_url": "data:audio/mpeg;base64,SUQzAwAAAAA..."
},
"request_id": "abc123def456",
"tips": "极数本源 · https://apizero.cn"
}免责声明
本接口免费版 TTS（基于公开 TTS 引擎），合成质量受文本内容和音色影响。说唱音色（male_rap）合成较慢（3-6 秒），其他音色通常 < 1 秒。生成音频版权归调用方，但不得用于诈骗、伪造、政治敏感等违规场景。本接口为单次请求 500 字限制，不支持流式输出。