听书
自定义音源
用一个 HTTP 请求接入自己的语音合成接口:在 App 里逐项填写,或从文件导入 JSON 规则。
自定义音源让你通过配置 HTTP 请求接入自己的语音合成服务:接口收到要读的文字,返回一段音频就行。需要多步认证、签名或 WebSocket 的接口,改用 自定义动态音源。
添加自定义音源
在 App 里填写
- 打开「设置 → 听书」,点右上角「+」
- 在「添加声音」里选「自定义音源」
- 填写「名称」「接口地址」「音色标识」,按需填「语言」「分组」「性别」「标签」
- 选择「请求方式」,按接口要求添加「请求头」,POST 请求再填「请求体」。要读的文字用
{{text}}占位 - 点「添加」,在声音列表里试听
填了「分组」的声音,会以分组名出现在「朗读引擎」列表里;没填的在「未分类」里。
从文件导入
已经写好规则文件时,在「设置 → 听书」右上角更多菜单里点「从文件导入」,选择 JSON 文件即可一次导入多个声音。规则文件的写法见下面的 规则格式。
规则格式
规则文件使用 JSON 数组格式,每个规则包含以下字段:
[
{
"url": "https://tts-service.example.com/api/v1/synthesize",
"name": "小美",
"voice": "voice-001",
"sex": 0,
"locale": "zh-CN",
"group": "自定义",
"tags": ["自定义", "女声"],
"params": {
"method": "POST",
"headers": {
"Content-Type": "application/json",
"Authorization": "Bearer your-api-key"
},
"body": "{\"text\":\"{{text}}\",\"voice\":\"voice-001\",\"speed\":1.0}"
}
},
{
"url": "https://tts-service.example.com/api/v1/synthesize",
"name": "小强",
"voice": "voice-002",
"sex": 1,
"locale": "zh-CN",
"group": "自定义",
"tags": ["自定义", "男声"],
"params": {
"method": "GET",
"headers": {
"Authorization": "Bearer your-api-key"
}
}
}
]字段说明
url: TTS 服务的 HTTP 接口地址name: 语音名称,用于在界面上显示voice: 语音 ID,用于标识具体的语音sex: 性别标识,0 表示女声,1 表示男声locale: 语言区域代码,如"zh-CN"、"en-US"等group: 分组名称,用于对语音进行分类tags: 标签列表,用于快速筛选和查找params: HTTP 请求参数配置method: HTTP 请求方法,如 "POST"、"GET" 等headers: HTTP 请求头body: HTTP 请求体,支持使用{{text}}作为文本占位符
请求方式说明
POST 请求
POST 请求通常用于发送较大的文本内容,支持在以下位置使用 {{text}} 占位符:
- 请求体(body)中:
{
"params": {
"method": "POST",
"headers": {
"Content-Type": "application/json",
"Authorization": "Bearer your-api-key"
},
"body": "{\"text\":\"{{text}}\",\"voice\":\"voice-001\",\"speed\":1.0}"
}
}- 请求头(headers)中:
{
"params": {
"method": "POST",
"headers": {
"Content-Type": "application/json",
"Authorization": "Bearer your-api-key",
"X-Text": "{{text}}"
},
"body": "{\"voice\":\"voice-001\",\"speed\":1.0}"
}
}GET 请求
GET 请求通常用于发送较小的文本内容,支持在以下位置使用 {{text}} 占位符:
- URL 查询参数中:
{
"url": "https://tts-service.example.com/api/v1/synthesize?text={{text}}&voice=voice-002&speed=1.0",
"params": {
"method": "GET",
"headers": {
"Authorization": "Bearer your-api-key"
}
}
}- 请求头(headers)中:
{
"url": "https://tts-service.example.com/api/v1/synthesize?voice=voice-002&speed=1.0",
"params": {
"method": "GET",
"headers": {
"Authorization": "Bearer your-api-key",
"X-Text": "{{text}}"
}
}
}注意事项
- 确保 TTS 服务地址可以正常访问
{{text}}占位符可以在请求头、请求体或 URL 查询参数中使用- 对于 GET 请求,建议使用 URL 查询参数或请求头传递文本
- 对于 POST 请求,建议使用请求体传递文本
- 建议在
tags中添加合适的标签,方便后续筛选 - 可以根据需要添加多个不同的语音配置
- 注意替换示例中的
your-api-key为实际的 API 密钥
Reeden