ReedenReeden
听书

自定义音源

用一个 HTTP 请求接入自己的语音合成接口:在 App 里逐项填写,或从文件导入 JSON 规则。

自定义音源让你通过配置 HTTP 请求接入自己的语音合成服务:接口收到要读的文字,返回一段音频就行。需要多步认证、签名或 WebSocket 的接口,改用 自定义动态音源。

添加自定义音源

在 App 里填写

  1. 打开「设置 → 听书」,点右上角「+」
  2. 在「添加声音」里选「自定义音源」
  3. 填写「名称」「接口地址」「音色标识」,按需填「语言」「分组」「性别」「标签」
  4. 选择「请求方式」,按接口要求添加「请求头」,POST 请求再填「请求体」。要读的文字用 {{text}} 占位
  5. 点「添加」,在声音列表里试听

填了「分组」的声音,会以分组名出现在「朗读引擎」列表里;没填的在「未分类」里。

从文件导入

已经写好规则文件时,在「设置 → 听书」右上角更多菜单里点「从文件导入」,选择 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}} 占位符:

  1. 请求体(body)中:
{
    "params": {
        "method": "POST",
        "headers": {
            "Content-Type": "application/json",
            "Authorization": "Bearer your-api-key"
        },
        "body": "{\"text\":\"{{text}}\",\"voice\":\"voice-001\",\"speed\":1.0}"
    }
}
  1. 请求头(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}} 占位符:

  1. 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"
        }
    }
}
  1. 请求头(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 密钥