📚 TTS Book Service
基于小米 MiMo TTS的听书音频转换服务，提供 Web 管理界面和听书 App 音频接入接口。
架构
听书 App ──HTTP──▶ 本服务 ──API──▶ 小米 MiMo TTS
│
├── SQLite (书籍/章节管理)
└── MP3 文件缓存
快速启动
# 1. 配置 API Key
cp .env.example .env
# 编辑 .env 填入你的 MIMO_API_KEY
# 2. 启动
docker compose up -d
# 3. 访问管理界面
# http://your-server:17200
功能
Web 管理界面 (/)
- 📖 书籍管理（添加/删除）
- 📑 章节管理（添加/编辑/删除）
- 🎙️ TTS 试听（支持风格设置）
- ⚡ 单章/批量音频生成
- ⚙️ 配置查看
听书 App 接口
| 接口 | 方法 | 说明 |
|---|---|---|
/api/book/{book_id} |
GET | 获取书籍信息和章节列表 |
/api/book/{book_id}/chapter/{chapter_id}/audio |
GET | 下载章节 MP3 音频 |
管理 API
| 接口 | 方法 | 说明 |
|---|---|---|
/admin/api/books |
GET/POST | 书籍列表/创建 |
/admin/api/books/{book_id} |
DELETE | 删除书籍 |
/admin/api/books/{book_id}/chapters |
GET/POST | 章节列表/创建 |
/admin/api/books/{book_id}/chapters/{id} |
PUT/DELETE | 更新/删除章节 |
/admin/api/books/{book_id}/chapters/{id}/generate |
POST | 生成单章音频 |
/admin/api/books/{book_id}/generate-all |
POST | 批量生成 |
/admin/api/tts/preview |
POST | TTS 试听 |
/admin/api/config |
GET | 查看配置 |
接入听书 App
- 在管理界面添加书籍和章节
- 为章节生成音频
- 在听书 App 配置：
- 接入方式: 音频方式
- 接入地址:
http://your-server:17200 - 音频类型: mp3
- 书籍地址:
http://your-server:17200/api/book/{book_id}
环境变量
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
MIMO_API_KEY |
✅ | - | 小米 MiMo TTS API Key |
MIMO_API_ENDPOINT |
❌ | https://api.xiaomimimo.com/v1/chat/completions |
API 地址 |
MIMO_TTS_MODEL |
❌ | mimo-v2-audio-tts |
模型名称 |
MIMO_VOICE |
❌ | mimo_default |
默认音色 |
SERVER_PORT |
❌ | 17200 |
服务端口 |
MiMo TTS 风格参考
在「TTS 试听」中可填写风格，例如：
| 类别 | 示例 |
|---|---|
| 情感 | 开心 / 悲伤 / 生气 / 平静 |
| 语速 | 语速慢 / 语速快 / 悄悄话 |
| 角色 | 像个大将军 / 像个小孩 / 孙悟空 |
| 方言 | 东北话 / 四川话 / 台湾腔 / 粤语 |
不使用 Docker 运行
pip install -r requirements.txt
# 需要系统安装 ffmpeg
export MIMO_API_KEY=your_key
cd app
python main.py