完善 README：小白友好的详细安装说明
This commit is contained in:
zwbcc
171
README.md
171
README.md
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
> 基于 MiniMax API 的文字转语音 Web 界面，单 HTML 文件，开箱即用。
|
> 基于 MiniMax API 的文字转语音 Web 界面，单 HTML 文件，开箱即用。
|
||||||
|
|
||||||
**在线地址（需在有网络的环境下访问）：** `http://10.0.10.110:8197/speech-t2a.html`
|
**在线地址：** `http://10.0.10.110:8197/speech-t2a.html`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -16,62 +16,171 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 快速使用
|
## 安装部署（三种方式任选其一）
|
||||||
|
|
||||||
### 1. 直接打开
|
### 方式一：直接用（推荐小白）
|
||||||
在浏览器访问：
|
|
||||||
```
|
直接用浏览器打开 HTML 文件，无需任何安装：
|
||||||
http://10.0.10.110:8197/speech-t2a.html
|
|
||||||
```
|
1. 下载 `speech-t2a.html` 文件
|
||||||
|
2. 双击用浏览器（Chrome/Edge/Firefox）打开即可
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 方式二：Python 一键启动（最简单）
|
||||||
|
|
||||||
|
适合有 Python 环境的用户（Windows/Mac/Linux 通用）：
|
||||||
|
|
||||||
|
**步骤：**
|
||||||
|
|
||||||
|
1. 下载本项目，解压到任意目录
|
||||||
|
2. 打开终端/命令行，进入项目目录：
|
||||||
|
|
||||||
### 2. 本地部署（Python）
|
|
||||||
```bash
|
```bash
|
||||||
|
# Windows 用户：按 Win+R，输入 cmd，然后：
|
||||||
|
cd C:\path\to\speech-t2a
|
||||||
|
|
||||||
|
# Mac/Linux 用户：打开终端，输入：
|
||||||
cd /path/to/speech-t2a
|
cd /path/to/speech-t2a
|
||||||
python3 -m http.server 8197
|
|
||||||
# 访问 http://localhost:8197/speech-t2a.html
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### 3. 本地部署（Nginx）
|
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
|
```nginx
|
||||||
server {
|
server {
|
||||||
listen 8197;
|
listen 8197;
|
||||||
root /path/to/speech-t2a;
|
server_name 你的域名或IP;
|
||||||
|
|
||||||
|
# 静态文件目录
|
||||||
|
root /var/www/speech-t2a;
|
||||||
index speech-t2a.html;
|
index speech-t2a.html;
|
||||||
|
|
||||||
|
# 允许浏览器访问
|
||||||
location / {
|
location / {
|
||||||
try_files $uri $uri/ =404;
|
try_files $uri $uri/ =404;
|
||||||
|
add_header Access-Control-Allow-Origin *;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
4. 重启 Nginx：
|
||||||
|
|
||||||
## API 说明
|
```bash
|
||||||
|
# 测试配置是否正确
|
||||||
|
sudo nginx -t
|
||||||
|
|
||||||
- **端点：** `POST https://api.minimaxi.com/v1/t2a_v2`
|
# 重启服务
|
||||||
- **备用：** `POST https://api-bj.minimaxi.com/v1/t2a_v2`
|
sudo systemctl restart nginx
|
||||||
- **认证：** `Authorization: Bearer <API_KEY>`
|
```
|
||||||
- **返回格式：** hex 编码的音频数据（非 base64）
|
|
||||||
|
5. 访问：**http://你的服务器IP:8197/speech-t2a.html**
|
||||||
|
|
||||||
|
> 💡 阿里云/腾讯云等云服务器需在安全组开放 `8197` 端口
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 模型列表
|
## API 申请与配置
|
||||||
|
|
||||||
| 模型 | 说明 |
|
### 1. 获取 MiniMax API Key
|
||||||
|------|------|
|
|
||||||
| `speech-2.8-hd` | 高清音质（推荐） |
|
1. 访问 [MiniMax 开放平台](https://platform.minimaxi.com/)
|
||||||
| `speech-2.6-hd` | 高清音质 |
|
2. 注册并登录
|
||||||
| `speech-2.8-turbo` | 快速生成 |
|
3. 进入控制台 → API Key → 创建新 Key
|
||||||
| `speech-2.6-turbo` | 快速生成 |
|
4. 复制 Key（格式类似 `Group-xxxxxxxxxxxxxxxx`）
|
||||||
| `speech-02-hd` | 克隆音质 |
|
|
||||||
| `speech-02-turbo` | 克隆快速 |
|
### 2. 填写到页面
|
||||||
|
|
||||||
|
1. 打开页面后，找到 **「API Key」** 输入框
|
||||||
|
2. 粘贴你的 Key
|
||||||
|
3. 点击 **「保存」** 或直接使用
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 已知问题
|
## 模型说明
|
||||||
|
|
||||||
- 音频数据为 hex 编码，需用 `parseInt(hex.substr(i*2, 2), 16)` 解码，不能用 `atob()`
|
| 模型 | 说明 | 推荐场景 |
|
||||||
- fetch 的 Authorization header 必须是纯 ASCII，API Key 中不能有非 ISO-8859-1 字符
|
|------|------|---------|
|
||||||
- 跨域音频无法使用 Web Audio API 分析器
|
| `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`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user