mitts

KO | EN

gitlite — search

#ai #typescript #llm #go #android #deep-learning #linux #nodejs #kubernetes #awesome-list #pytorch #security #ios #openai

(★ 26)

为「阅读」App（legado）提供Xiaomi MiMo TTS语音合成服务

mitts Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 小米 TTS for 阅读

为 [legado](https://github.com/gedoor/legado) 阅读 App 提供小米 MiMo TTS 语音合成服务。

![Web 界面](https://raw.githubusercontent.com/ISuuuu/mitts/main/screenshot.png)

## 功能特性

- 支持模型: 🎤 mimo-v2.5-tts · 🎨 mimo-v2.5-tts-voicedesign · 🔊 mimo-v2.5-tts-voiceclone
- 支持 API 端点切换（小米 MiMo / TokenPlan）
- 支持 legado 阅读 App 一键导入
- 在线试听

## 模型版本

| 版本 | 模型名称 | 说明 |
|------|----------|------|
| **V2.5 内置音色（推荐）** | `mimo-v2.5-tts` | 内置8种音色，快速上手 |
| **V2.5 VoiceDesign** | `mimo-v2.5-tts-voicedesign` | 文本描述定制音色 |
| **V2.5 VoiceClone** | `mimo-v2.5-tts-voiceclone` | 上传音频复刻任意音色 |

## API 端点

| 端点 | 地址 | 说明 |
|------|------|------|
| **小米 MiMo** | `https://api.xiaomimimo.com/v1` | 官方 API |
| **TokenPlan** | `https://token-plan-cn.xiaomimimo.com/v1` | TokenPlan 服务 |

## V2.5 三种模式说明

### 1. 内置音色模式
使用官方预设的音色，无需额外配置。

### 2. VoiceDesign（音色设计）
通过文本描述来定制音色特征，例如：
- "温柔的女声，略带磁性"
- "活泼可爱的萝莉音"
- "低沉磁性的男声"

### 3. VoiceClone（音色克隆）
上传一段音频样本（MP3/WAV），AI 会学习该音频的音色特征，用于生成语音。

**使用要求：**
- 支持 MP3、WAV 格式
- 音频时长建议 5-30 秒
- 音频质量越好，克隆效果越好

## 音色列表

### V2.5 内置音色

| 音色 ID | 名称 | 特点 |
|---------|------|------|
| `冰糖` | 冰糖-活泼女声 | 活泼可爱 |
| `茉莉` | 茉莉-温柔女声 | 温柔细腻 |
| `苏打` | 苏打-清新男声 | 清新自然 |
| `白桦` | 白桦-知性男声 | 知性优雅 |
| `Mia` | Mia-英文女声 | 英文女声 |
| `Chloe` | Chloe-英文女声 | 英文女声 |
| `Milo` | Milo-英文男声 | 英文男声 |
| `Dean` | Dean-英文男声 | 英文男声 |

## 快速部署

### Vercel 部署（推荐）

[![Deploy to Vercel](https://vercel.com/button)](https://vercel.com/new)

fork 本项目后，点击上方按钮进入 Vercel，选择并导入您的仓库即可一键部署。部署完成后在页面手动输入 API Key 即可使用。

### 本地部署

#### 1. 克隆项目

```bash
git clone https://github.com/ISuuuu/xiaomitts.git
cd xiaomitts
```

#### 2. 安装依赖

```bash
# 创建虚拟环境
uv venv py310 --python 3.10

# 激活虚拟环境
# Windows
py310\Scripts\activate
# Linux/macOS
source py310/bin/activate

# 安装依赖
uv pip install -r requirements.txt
```

#### 3. 启动服务

```bash
python main.py
```

服务默认运行在 `http://localhost:8099`

#### 后台运行（推荐）

```bash
pm2 start python --name "mitts" -- main.py
```

## 导入到阅读 App

1. 在本项目页面输入 API Key，点击 **直接导入** 
 **或者**
1. **扫码导入**  浏览器中获取链接
2. 打开阅读 App
3. 点击屏幕中心 弹出菜单 长按**朗读** → **朗读引擎**
4. 选择 **网络导入**

## API 接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/` | GET | Web 管理界面 |
| `/tts` | GET | 语音合成接口 |
| `/api/legado-import` | GET | 阅读 App 导入配置 |

### TTS 参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `api_key` | 是 | API Key |
| `text` | 是 | 要合成的文本 |
| `model` | 否 | 模型版本，默认 `v2.5`（可选 `v2.5`、`v2.5_design`、`v2.5_clone`） |
| `voice` | 否 | 音色（v2.5）或音色描述（VoiceDesign） |
| `audio` | 否 | 音频样本 base64（VoiceClone 模式） |
| `endpoint` | 否 | API 端点，默认 `xiaomimimo`（可选 `xiaomimimo`、`tokenplan`） |

## License

MIT

mitts

mitts Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

mitts

mitts Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README