MiniMax TTS 文字转语音工具

基于 MiniMax API 的文字转语音 Web 界面，单 HTML 文件，开箱即用。

---

🚀 推广

MiniMax Token Plan 惊喜上线！ 新增语音、音乐、视频和图片生成权益。邀请好友享双重好礼，助力开发体验！

好友立享 9折 专属优惠 + Builder 权益，你赢返利 + 社区特权！

👉 立即参与：https://platform.minimaxi.com/subscribe/token-plan?code=6DMYqmSJX2&source=link

---

功能特性

• 🌐 支持 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. 打开终端/命令行，进入项目目录：

# Windows 用户：按 Win+R，输入 cmd，然后：
cd C:\path\to\speech-t2a

# Mac/Linux 用户：打开终端，输入：
cd /path/to/speech-t2a

3. 运行启动命令：

python3 -m http.server 8197

4. 打开浏览器，访问：http://localhost:8197/speech-t2a.html

⚠️ 关闭终端会停止服务，需要保持窗口开启

---

方式三：Nginx 部署（适合有服务器的用户）

适合有云服务器、软路由、NAS 等设备的用户，可长期运行：

步骤：

1. 将 speech-t2a.html 上传到服务器，例如 /var/www/speech-t2a/
2. 编辑 Nginx 配置：

sudo vim /etc/nginx/conf.d/speech-t2a.conf

3. 写入以下配置：

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：

# 测试配置是否正确
sudo nginx -t

# 重启服务
sudo systemctl restart nginx

5. 访问：http://你的服务器IP:8197/speech-t2a.html

💡 阿里云/腾讯云等云服务器需在安全组开放 8197 端口

---

API 申请与配置

1. 获取 MiniMax API Key

1. 访问 MiniMax 开放平台
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

---

截图