Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MiMo TTS - 小米语音合成 Claude Code Skill

基于小米 MiMo-V2.5-TTS 系列模型的语音合成工具,支持 Claude Code 直接调用。

✨ 功能特性

  • 🎤 预置音色合成 - 8种精品音色开箱即用(冰糖、茉莉、苏打、白桦等)
  • 🎨 音色设计 - 通过文本描述自定义音色(如"沙哑沧桑的青年男性")
  • 🔊 音色克隆 - 基于音频样本复刻任意音色
  • 🎭 风格控制 - 支持情绪、方言、角色扮演、唱歌等多种风格
  • 🎵 唱歌模式 - 支持中文歌词演唱

📦 安装

1. 克隆项目

git clone https://github.com/binyuli/mimo-tts-skill.git ~/.claude/skills/mimo-tts

2. 安装依赖

pip install openai

3. 配置 API Key

  1. 访问 Xiaomi MiMo 开放平台 获取 API Key
  2. 复制 .env.example 为 .env.mimo
  3. 填入你的 API Key
cp ~/.claude/skills/mimo-tts/.env.example ~/.claude/skills/mimo-tts/.env.mimo
# 编辑 ~/.claude/skills/mimo-tts/.env.mimo,填入你的 API Key

4. 安装 Claude Code 命令

将 commands/mimo-tts.md 复制到命令目录:

# macOS/Linux
cp ~/.claude/skills/mimo-tts/commands/mimo-tts.md ~/.claude/commands/

# Windows (PowerShell)
Copy-Item ~/.claude/skills/mimo-tts/commands/mimo-tts.md $env:USERPROFILE\.claude\commands\

🚀 使用方法

在 Claude Code 中使用

/mimo-tts 你好世界
/mimo-tts 你好世界 --voice 茉莉
/mimo-tts "(唱歌)歌词内容" --voice 苏打
/mimo-tts "文字内容" --mode design --design "音色描述"
/mimo-tts "文字内容" --mode clone --clone reference.wav

命令行直接使用

python ~/.claude/skills/mimo-tts/mimo-tts.py "你好世界"
python ~/.claude/skills/mimo-tts/mimo-tts.py "你好世界" --voice 茉莉
python ~/.claude/skills/mimo-tts/mimo-tts.py "(唱歌)歌词" --voice 苏打

📋 支持的模型

Model ID 功能 说明
mimo-v2.5-tts 预置音色合成 支持唱歌,不支持音色设计/克隆
mimo-v2.5-tts-voicedesign 音色设计 通过文本描述生成音色
mimo-v2.5-tts-voiceclone 音色克隆 基于音频样本复刻音色

🎤 预置音色

音色名 Voice ID 语言 性别
冰糖 冰糖 中文 女性
茉莉 茉莉 中文 女性
苏打 苏打 中文 男性
白桦 白桦 中文 男性
Mia Mia 英文 女性
Chloe Chloe 英文 女性
Milo Milo 英文 男性
Dean Dean 英文 男性

🎭 风格控制

标签控制(推荐)

在文本开头添加 (风格) 标签:

# 基础情绪
"(开心)你好!"
"(悲伤)再见了..."
"(愤怒)你怎么能这样!"

# 方言
"(东北话)哎呀妈呀!"
"(四川话)要得嘛!"
"(粤语)唔该晒!"
"(台湾腔)真的假的!"

# 唱歌
"(唱歌)歌词内容"

自然语言控制

通过 --style 参数传入自然语言描述:

python mimo-tts.py "你好" --style "用轻快上扬的语调,语速稍快,带着激动"

🎨 音色设计

使用 --mode design 通过文本描述创建自定义音色:

python mimo-tts.py "你好世界" --mode design --design "一个沙哑沧桑的青年男性声音,像经历过很多故事"

🔊 音色克隆

使用 --mode clone 基于参考音频克隆音色:

python mimo-tts.py "你好世界" --mode clone --clone /path/to/reference.wav

📁 项目结构

~/.claude/
├── commands/
│   └── mimo-tts.md      # Claude Code 命令文件
└── skills/
    └── mimo-tts/
        ├── mimo-tts.py  # 主脚本
        ├── .env.mimo    # API Key 配置
        └── .env.example # 环境变量示例

⚠️ 注意事项

  1. API Key 安全:.env.mimo 文件包含你的 API Key,请勿分享
  2. Token Plan 用户:如果你的 API Key 以 tp- 开头,脚本会自动使用 Token Plan 的 URL
  3. 精简设计:使用 commands 格式,每次调用只读取一个小文件,省 token

🔗 相关链接

📄 License

MIT License

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages