一行命令将文本转换为自然语音，支持音色克隆。

• Python >= 3.10
• 网络连接（需访问 VoxCPM API 服务器，如需使用API请加入QQ群：321776831）
• 首次运行自动安装 aiohttp 依赖

无需额外安装步骤，直接运行脚本即可。首次运行会自动安装 Python 依赖。

python voxcpm_tts.py "你好，欢迎使用语音合成"

python voxcpm_tts.py "Hello world." -o hello.mp3

python voxcpm_tts.py "今天天气不错" --prompt ref.wav

python voxcpm_tts.py "今天天气不错" --prompt ref.wav --prompt-text "参考音频中说的文字"

python voxcpm_tts.py "测试" --api http://your-server:8000

参数	说明	默认值
text	要合成的目标文本（必需）	-
-o, --output	输出 MP3 文件路径	output.mp3
--prompt	参考音频文件路径	无
--prompt-text	参考音频对应文本	无
--cfg	CFG 值	2
--api	API 服务器默认地址	http://43.143.233.233:8000

voxcpm2-skill/
├── SKILL.md          # Skill 定义文件（AI Agent 读取）
├── README.md         # 本文件
├── voxcpm_tts.py     # 主脚本（CLI 入口）
├── client.py         # 原始 API 客户端示例
└── prompt_audio.wav  # 参考音频示例

• GitHub: https://github.com/OpenBMB/VoxCPM
• ModelScope: https://www.modelscope.cn/models/OpenBMB/VoxCPM2