参数名	类型	必填	说明	示例
type	string	是	可为baidu、xunfei（即为百度、讯飞）	baidu
id	integer	是	当type为讯飞（xunfei）时，id值为1~20，分别为讯飞-七哥（男声）、讯飞-子晴（女声）、讯飞-一菲（女声）、讯飞-小露（女声）、讯飞-小鹏（男声）、讯飞-萌小新（男声）、讯飞-小雪（女声）、讯飞-超哥（男声）、讯飞-小媛（女声）、讯飞-叶子（女声）、讯飞-千雪（女声）、讯飞-小忠（男声）、讯飞-万叔（男声）、讯飞-虫虫（女声）、讯飞-楠楠（儿童-男）、讯飞-晓璇（女声）、讯飞-芳芳（儿童-女）、讯飞-嘉嘉（女声）、讯飞-小倩（女声）、讯飞-Catherine（女声-英文专用）；当为百度时，对应关系如下：一、男声类 0→度小美 - 标准女主播、3→度逍遥 - 情感男声、106→度博文 - 专业男主播、4003→度逍遥 - 情感男声、4106→度博文 - 专业男主播、4115→度小贤 - 电台男主播、4129→度小彦 - 知识男主播、4164→度阿肯 - 主播男声、4176→度有为 - 磁性男声、5003→度逍遥 - 情感男声、5971→度皮特 - 老外男声、6205→度悠然 - 旁白男声、6546→度清豪 - 逍遥侠客、6602→度清柔 - 温柔男神、6746→度书道 - 沉	4259
msg	string	是	需要文字转语音的文字内容。	你好，这里是慕名api，欢迎使用

文字转语音

接口说明

文字转语音接口支持将文本内容快速转换为语音输出，集成百度和讯飞两大主流语音引擎，提供丰富的音色选择。百度语音库涵盖43种音源品质，讯飞语音库提供20种音色，适用于语音播报、内容创作、有声读物等多种场景。

调用地址

/v1/zs_tts.php

请求方式

支持 GET 与 POST 两种请求方式。

鉴权说明

本接口无需密钥，调用时无需进行身份验证即可直接使用。

请求参数

参数名	类型	必填	说明
type	string	是	语音提供商，支持 baidu（百度）或 xunfei（讯飞）
id	integer	是	语音音色 ID，对应不同声音类型
msg	string	是	需要转换为语音的文字内容

id 参数取值说明

讯飞（xunfei）时，id 取值 1~20：

ID	音色名称	ID	音色名称
1	讯飞-七哥（男声）	2	讯飞-子晴（女声）
3	讯飞-一菲（女声）	4	讯飞-小露（女声）
5	讯飞-小鹏（男声）	6	讯飞-萌小新（男声）
7	讯飞-小雪（女声）	8	讯飞-超哥（男声）
9	讯飞-小媛（女声）	10	讯飞-叶子（女声）
11	讯飞-千雪（女声）	12	讯飞-小忠（男声）
13	讯飞-万叔（男声）	14	讯飞-虫虫（女声）
15	讯飞-楠楠（儿童-男）	16	讯飞-晓璇（女声）
17	讯飞-芳芳（儿童-女）	18	讯飞-嘉嘉（女声）
19	讯飞-小倩（女声）	20	讯飞-Catherine（女声-英文专用）

百度（baidu）时，常见音色 ID 如下：

ID	音色名称	ID	音色名称
0	度小美（标准女声）	3	度逍遥（情感男声）
106	度博文（专业男主播）	4003	度逍遥（情感男声）
4106	度博文（专业男主播）	4115	度小贤（电台男主播）
4129	度小彦（知识男主播）	4164	度阿肯（主播男声）
4176	度有为（磁性男声）	4259	度小新（播音女声）
5003	度逍遥（情感男声）	5971	度皮特（老外男声）
6205	度悠然（旁白男声）	6546	度清豪（逍遥侠客）
6602	度清柔（温柔男神）	6746	度书道（沉稳男声）

成功响应示例

{
  "code": 200,
  "voice": {
    "voice_name": "度小新-播音女声",
    "quality_name": "臻品音色",
    "pre": 4259
  },
  "msg": "你好，这里是慕名api，欢迎使用",
  "tts": "https://xiaoapi.cn/v1/log/b19e5fdb51e7cae965af99e094aa89a3.mp3",
  "tips": "慕名API：http://xiaoapi.cn"
}

响应字段说明

字段名	类型	说明
code	integer	状态码，200 表示成功
voice	object	语音配置信息
voice.voice_name	string	语音名称
voice.quality_name	string	音色品质名称
voice.pre	integer	语音 ID
msg	string	输入的原始文本内容
tts	string	生成的语音文件访问地址
tips	string	服务提示信息

错误响应示例

接口调用失败时，返回统一错误响应结构：

{"code":0,"msg":"请求过于频繁，请稍后再试","errcode":11005}

业务错误码说明

errcode	说明
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用
11023	密钥已过期
11024	令牌分配积分不足

调用示例

终端 curl（bash）

# GET 请求示例 - 调用百度语音合成臻品音色女声
curl "http://xiaoapi.cn/v1/zs_tts.php?type=baidu&id=4259&msg=你好，这里是慕名api，欢迎使用"

# POST 请求示例 - 调用讯飞语音合成
curl -X POST "http://xiaoapi.cn/v1/zs_tts.php" \
  -d "type=xunfei&id=1&msg=你好，这里是慕名api，欢迎使用"

PHP

// GET 请求示例
$url = "http://xiaoapi.cn/v1/zs_tts.php?type=baidu&id=4259&msg=" . urlencode("你好，这里是慕名api，欢迎使用");
$result = file_get_contents($url);
echo $result;

// POST 请求示例
$ch = curl_init("http://xiaoapi.cn/v1/zs_tts.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    "type" => "xunfei",
    "id" => 1,
    "msg" => "你好，这里是慕名api，欢迎使用"
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;

注意事项

请求方式：支持 GET 与 POST 两种方式提交请求。
必填参数：调用时必须传入 type、id、msg 三个参数，缺一不可。
type 取值：仅支持 baidu（百度）或 xunfei（讯飞）两种语音源，传入其他值将返回错误。
id 取值范围：当 type 为 baidu 时，id 取值范围为 0、3、106、4003、4106、4115、4129、4164、4176、5003、5971、6205、6546、6602、6746 等百度音库编号；当 type 为 xunfei 时，id 取值范围为 1~20，分别对应不同讯飞语音角色，请根据实际需求选取对应编号。
msg 长度：建议单次转换文字不超过 500 字，过长内容可能被截断或转换失败。
返回内容：接口直接返回音频文件 URL（tts 字段），可直接用于播放或下载，无需额外解析。
结果校验：建议先检查返回的 code 字段是否为 200，若非 200 则表示转换失败，请勿直接使用 tts 链接。

文字转语音

请求参数

返回示例

详细文档

文字转语音

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

QQ音乐