AI TTS 语音合成工具

支持 MiniMax 国内版(api.minimaxi.com)和国际版(api.minimax.io) API。

快速开始

1. 设置 API Key

bash

国内版 (sk-api-xxx 格式)

export MINIMAXAPIKEY=sk-api-xxx

国际版

export MINIMAXAPIKEY=your-key

2. 生成语音

bash

自动选择最佳音色

python3 tts.py 你好世界

指定语言/风格

python3 tts.py Hello world --language english --gender female

粤语推荐使用 language_boost

python3 tts.py 你好 --language cantonese --language-boost Chinese,Yue

指定音色

python3 tts.py 你好 --voice girlfriend5speech02_01

列出音色

python3 tts.py --list-voices

参数说明

参数	简写	说明	默认值
--text		要转语音的文本	(必填)
--voice

-v | 音色ID | 自动匹配 | | --language | -l | 语言 | auto | | --gender | -g | 性别 (male/female) | auto | | --age | | 年龄 (young/middle/elder/child) | auto | | --style | -s | 风格 | auto | | --language-boost | -b | 语言增强 | auto | | --model | -m | 模型 | speech-2.8-turbo | | --speed | | 语速 (0.5-2.0) | 1.0 | | --format | -f | 格式 (mp3/wav/flac) | mp3 | | --output | -o | 输出文件 | output.mp3 | | --api | | API版本 (cn/int) | cn | | --list-voices | | 列出音色 | - |

Language Boost (语言增强)

--language-boost 参数用于增强对小语种和方言的识别能力：

语言	Boost 值
普通话	Chinese
粤语

Chinese,Yue |
| 英语 | English |
| 日语 | Japanese |
| 韩语 | Korean |
| 自动检测 | auto |

注意： 粤语必须使用 Chinese,Yue，不是 Cantonese！

bash

粤语示例

python3 tts.py 你食咗未呀 --language cantonese --language-boost Chinese,Yue

英语示例

python3 tts.py Hello world --language english --language-boost English

黄金音色推荐

✨ 中文 (Mandarin)

音色ID	说明	风格
girlfriend5speech0201	温柔治愈	女声
girlfriend1speech0201

甜美软萌 | 女声 |

| ttv-voice-2026011810595326-hxYkopxR | 活泼吐槽 | 女声 | | ttv-voice-2026011806464526-IPLmlZ8C | 清爽阳光 | 男声 | | ttv-voice-2026011910402426-5fSKtVmM | 幽默大叔 | 男声 |

🌐 English

音色ID	说明
englishvoiceagentivcfemalenora	自然女声
englishvoiceagentivcmalejulian

自然男声 |

| englishvoiceagentivcfemale_maya | 年轻女声 |

🇭🇰 Cantonese 粤语

音色ID	说明
HKCantonesefemale1	标准港女
Cantonese_ProfessionalHost（M)

专业男主持 |

🇹🇼 Taiwan 台湾国语

音色ID	说明
vcwanwan0303_01	台湾女生

🇯🇵 Japanese

音色ID	说明
JapaneseDecisivePrincess	果断公主
JapaneseIntellectualSenior

睿智老人 |

🇰🇷 Korean

音色ID	说明
Korean_SweetGirl	甜妹

使用示例

视频配音 (Dubbing)

bash

中文女声配音

python3 tts.py 欢迎观看本期节目 --voice girlfriend5speech02_01 --output intro.mp3

英文配音

python3 tts.py Welcome to our channel --language english --gender female --output intro_en.mp3

粤语配音 (强烈建议使用 language_boost)

bash

粤语女声

python3 tts.py 你食咗未呀 --language cantonese --language-boost Chinese,Yue --voice HKCantonesefemale1

粤语男声

python3 tts.py 大家好 --language cantonese --language-boost Chinese,Yue --voice Cantonese_ProfessionalHost（M)

有声书/朗读

bash

温柔女声朗读

python3 tts.py 从前有座山 --style gentle

故事讲述

python3 tts.py 这是一个有趣的故事 --voice ttv-voice-2026011810595326-hxYkopxR

语音克隆

bash

使用你的克隆音色

python3 tts.py 这是我的声音 --voice jiachuan_0115

语言代码

代码	语言
chinese	普通话
cantonese

粤语 (推荐配合 language-boost) | | english | 英语 | | japanese | 日语 | | korean | 韩语 | | taiwan | 台湾国语 |

API 版本

• - --api cn: 国内版 (api.minimaxi.com)
• --api int: 国际版 (api.minimax.io)