ms-ra-forwarder 项目介绍
ms-ra-forwarder 是一个旨在帮助用户方便地部署和调用微软 Edge 浏览器“大声朗读”功能以及 Azure TTS 演示页面接口的项目。它为希望使用微软文本转语音服务创建语音合成应用的开发人员提供了一种简单的方式。下面是对该项目的详细介绍。
部署方式
ms-ra-forwarder 提供了多种部署方式,用户可以根据自己的需求和条件选择合适的部署方法。
部署到 Vercel
用户可以通过 Vercel 平台快速部署此项目,详细过程请参考相关的演示视频。需要注意的是,在部署之前建议先 Fork 一份代码,确保项目的独立性。
部署到 Railway
在 Railway 上部署虽然简便,但受限于每月500小时的使用限制,因此不是长时间稳定运行的最佳选择。建议有条件的用户选择 Docker 来部署。
部署到 Heroku
Heroku 是另一个云平台选择,只需点击对应的按钮即可轻松部署。
Docker 部署(推荐)
Docker 是 ms-ra-forwarder 推荐的部署方式。用户需要安装 Docker,并通过命令行拉取镜像和运行容器。可以选择设置环境变量 TOKEN
来限制访问。
采用 Docker Compose 也能够简化服务的管理,用户需要创建一个 docker-compose.yml
文件并按照提供的配置运行服务。
手动运行
对于喜欢直接掌控项目过程的用户,可以选择手动运行。需要先安装 git 和 nodejs,然后通过命令行获取代码并安装依赖,最终运行服务。
使用方法
ms-ra-forwarder 提供了两种主要的使用方式:
导入到阅读应用(legado)
用户可以在部署好的网页上测试功能,并生成阅读应用(legado)的语音引擎链接进行导入。
手动调用接口
可通过 POST 请求调用接口 /api/ra
,请求正文支持 ssml 格式,以定制语音发音特性,尤其适用于需要自定义发音人和讲话风格的场合。
访问限制
为了防止他人滥用服务,用户可以通过设置环境变量 TOKEN
来限制访问。请求时需要在请求头中加入 Authorization: Bearer <TOKEN>
来进行访问验证。
注意事项
- 微软的 Azure TTS 服务提供了一定的免费额度,用户如对免费额度满意,请优先使用官方服务。
- ms-ra-forwarder 项目的接口依赖于微软的 Edge 浏览器和 Azure 服务,不保证长期稳定性和可用性。
- 项目用途仅供学习和参考,请勿用于商业用途。
重要更新
- 2023-04-19: Azure 下线了一些功能,需要迁移到 Edge 接口。
- 其他历史更新记录包括对 Docker 仓库地址调整、Azure TTS API 的兼容调整等。
ms-ra-forwarder 项目得到了多个组织和个人的支持与贡献,使得普通用户能够更轻松地利用微软的文本转语音服务。