# tts文本转语音接口

**请求方式：** POST

**接口地址：** https://v2.xxapi.cn/api/tts

**接口描述：** 将文本合成为 MP3 音频并返回访问链接，支持 55 种中文女声、45 种中文男声和 3 种英文女声，可调节语速，也可直接重定向至音频链接。

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| text | text | body | 必传 | — | — | 待合成文本，不能为空。最大传递400字符 |
| voice | voice | body | 可选 | — | — | 音色别名，默认 female_1。中文女声：female_1～female_55（55 个）；中文男声：male_1～male_45（45 个）；美式英语女声：american_female_1、american_female_2；英式英语女声：british_female_1，共 103 个。<br>声音试听：https://cdn.xxhzm.cn/api/tts-voices/(音色).mp3 |
| speed | speed | body | 可选 | — | — | 语速，默认 1，支持 0.25～4 之间的数字（含边界）。小于 1 为减速，大于 1 为加速；例如 1.25。 |
| lang_code | lang_code | body | 可选 | — | — | 文本处理语言代码，可省略；不传时由语音服务根据所选音色自动确定语言。一般无需设置，应选择与文本语言匹配的 voice。 |
| return | json \| 302 | body | 可选 | — | — | 传递return=302重定向到音频 |
| Authorization | Bearer <access_key> | header | 必传 | Bearer <access_key> | — | 请登录后前往控制面板查询 API Key |

## 返回示例

```json
{
  "code": 200,
  "msg": "",
  "data": "https://v2.xxapi.cn/cache/tts/0123456789abcdef0123456789abcdef.mp3"
}
```