188 lines
4.0 KiB
Markdown
188 lines
4.0 KiB
Markdown
# MiniMax TTS 文字转语音工具
|
||
|
||
> 基于 MiniMax API 的文字转语音 Web 界面，单 HTML 文件，开箱即用。
|
||
|
||
---
|
||
|
||
## 功能特性
|
||
|
||
- 🌐 支持 MiniMax 全部 TTS 模型（speech-2.8-hd、speech-02-hd 等）
|
||
- 🔄 支持 hex 音频流实时播放（自动解码）
|
||
- 📦 支持下载为 .wav 文件
|
||
- ⚙️ 实时调节语速
|
||
- 🎯 自动携带认证头
|
||
|
||
---
|
||
|
||
## 安装部署（三种方式任选其一）
|
||
|
||
### 方式一：直接用（推荐小白）
|
||
|
||
直接用浏览器打开 HTML 文件，无需任何安装：
|
||
|
||
1. 下载 `speech-t2a.html` 文件
|
||
2. 双击用浏览器（Chrome/Edge/Firefox）打开即可
|
||
|
||
---
|
||
|
||
### 方式二：Python 一键启动（最简单）
|
||
|
||
适合有 Python 环境的用户（Windows/Mac/Linux 通用）：
|
||
|
||
**步骤：**
|
||
|
||
1. 下载本项目，解压到任意目录
|
||
2. 打开终端/命令行，进入项目目录：
|
||
|
||
```bash
|
||
# Windows 用户：按 Win+R，输入 cmd，然后：
|
||
cd C:\path\to\speech-t2a
|
||
|
||
# Mac/Linux 用户：打开终端，输入：
|
||
cd /path/to/speech-t2a
|
||
```
|
||
|
||
3. 运行启动命令：
|
||
|
||
```bash
|
||
python3 -m http.server 8197
|
||
```
|
||
|
||
4. 打开浏览器，访问：**http://localhost:8197/speech-t2a.html**
|
||
|
||
> ⚠️ 关闭终端会停止服务，需要保持窗口开启
|
||
|
||
---
|
||
|
||
### 方式三：Nginx 部署（适合有服务器的用户）
|
||
|
||
适合有云服务器、软路由、NAS 等设备的用户，可长期运行：
|
||
|
||
**步骤：**
|
||
|
||
1. 将 `speech-t2a.html` 上传到服务器，例如 `/var/www/speech-t2a/`
|
||
2. 编辑 Nginx 配置：
|
||
|
||
```bash
|
||
sudo vim /etc/nginx/conf.d/speech-t2a.conf
|
||
```
|
||
|
||
3. 写入以下配置：
|
||
|
||
```nginx
|
||
server {
|
||
listen 8197;
|
||
server_name 你的域名或IP;
|
||
|
||
# 静态文件目录
|
||
root /var/www/speech-t2a;
|
||
index speech-t2a.html;
|
||
|
||
# 允许浏览器访问
|
||
location / {
|
||
try_files $uri $uri/ =404;
|
||
add_header Access-Control-Allow-Origin *;
|
||
}
|
||
}
|
||
```
|
||
|
||
4. 重启 Nginx：
|
||
|
||
```bash
|
||
# 测试配置是否正确
|
||
sudo nginx -t
|
||
|
||
# 重启服务
|
||
sudo systemctl restart nginx
|
||
```
|
||
|
||
5. 访问：**http://你的服务器IP:8197/speech-t2a.html**
|
||
|
||
> 💡 阿里云/腾讯云等云服务器需在安全组开放 `8197` 端口
|
||
|
||
---
|
||
|
||
## API 申请与配置
|
||
|
||
### 1. 获取 MiniMax API Key
|
||
|
||
1. 访问 [MiniMax 开放平台](https://platform.minimaxi.com/)
|
||
2. 注册并登录
|
||
3. 进入控制台 → API Key → 创建新 Key
|
||
4. 复制 Key（格式类似 `Group-xxxxxxxxxxxxxxxx`）
|
||
|
||
### 2. 填写到页面
|
||
|
||
1. 打开页面后，找到 **「API Key」** 输入框
|
||
2. 粘贴你的 Key
|
||
3. 点击 **「保存」** 或直接使用
|
||
|
||
---
|
||
|
||
## 模型说明
|
||
|
||
| 模型 | 说明 | 推荐场景 |
|
||
|------|------|---------|
|
||
| `speech-2.8-hd` | 高清音质 | 通用场景（推荐） |
|
||
| `speech-2.6-hd` | 高清音质 | 备用选择 |
|
||
| `speech-2.8-turbo` | 快速生成 | 追求速度 |
|
||
| `speech-2.6-turbo` | 快速生成 | 追求速度 |
|
||
| `speech-02-hd` | 克隆音质 | 声音克隆 |
|
||
| `speech-02-turbo` | 克隆快速 | 声音克隆 |
|
||
|
||
---
|
||
|
||
## 使用流程
|
||
|
||
```
|
||
1. 打开页面
|
||
↓
|
||
2. 填写 API Key
|
||
↓
|
||
3. 输入要转语音的文字
|
||
↓
|
||
4. 选择语速（默认 1.0）
|
||
↓
|
||
5. 点击「生成」
|
||
↓
|
||
6. 等待播放 / 下载音频
|
||
```
|
||
|
||
---
|
||
|
||
## 常见问题
|
||
|
||
### Q: 播放没声音？
|
||
- 检查浏览器是否允许页面播放音频
|
||
- 确认 API Key 填写正确
|
||
- 查看浏览器控制台（F12）是否有报错
|
||
|
||
### Q: 生成失败？
|
||
- 确认 API Key 有效且有余额
|
||
- 检查网络是否能访问 MiniMax API
|
||
- 确认文字内容不为空
|
||
|
||
### Q: 音频是 hex 编码无法播放？
|
||
- 这是正常现象，页面会自动解码并播放
|
||
- 如需原始文件，点击「下载」按钮
|
||
|
||
### Q: 如何长期运行不丢服务？
|
||
- 推荐用 **Nginx 部署**（方式三）
|
||
- 或使用 PM2、Systemd 等进程管理工具
|
||
|
||
---
|
||
|
||
## 技术信息
|
||
|
||
- **单文件**：仅需一个 HTML 文件，无需后端
|
||
- **跨平台**：浏览器支持的系统都能用
|
||
- **离线可用**：页面加载后即可离线生成（需已填 API Key）
|
||
- **API 端点**：`https://api.minimaxi.com/v1/t2a_v2`
|
||
- **备用端点**：`https://api-bj.minimaxi.com/v1/t2a_v2`
|
||
|
||
---
|
||
|
||
## 截图
|
||
|
||
|