当前位置：首页 > news >正文

【笔记】CosyVoice 模型下载小记：简单易懂的两种方法对比

news 来源：原创 2025/5/16 9:46:39

#工作记录

笔记标签：#CosyVoice 模型 #模型下载 #ModelScope #Git LFS #语音合成开发

一、强烈推荐：用 ModelScope SDK 下载（简单又靠谱）

1.1 好处多多

不容易出错：能自动把模型需要的所有东西都下载好，不用担心漏文件导致模型用不了。

不用特殊网络：在国内正常网络就能下载，万一断网了，重新运行还能接着下。

总保持最新：官方更新模型功能，用这个方法下载就能直接用新功能。

1.2 具体步骤

创建下载脚本：新建一个叫models_download.py的文件，把下面代码复制进去：

# 导入下载工具from modelscope import snapshot_download# 下载基础模型snapshot_download('iic/CosyVoice-300M', local_dir='pretrained_models/CosyVoice-300M')# 下载微调版本snapshot_download('iic/CosyVoice-300M-SFT', local_dir='pretrained_models/CosyVoice-300M-SFT')# 下载另一个版本snapshot_download('iic/CosyVoice-300M-Instruct', local_dir='pretrained_models/CosyVoice-300M-Instruct')# 下载语音合成要用的模型snapshot_download('speech_tts/speech_kantts_ttsfrd', local_dir='pretrained_models/speech_kantts_ttsfrd')

运行代码：打开终端，先激活我们项目的虚拟环境，再输入命令python models_download.py 。等它下载完就行，如果遇到权限问题，加个--no-cache-dir参数试试。

python models_download.py

实验记录：我自己测试时，第一次下载到一半断网了，重新运行代码后，它真的接着上次的进度继续下载，很方便！

二、备选方法：用 Git LFS 下载（麻烦，不推荐）

2.1 准备工作

要用这个方法，得先安装 Git LFS，这是专门用来下载大文件的工具，因为模型文件都很大。

2.2 下载命令

在终端输入下面命令：

# 创建放模型的文件夹mkdir -p pretrained_models# 下载基础模型git clone https://www.modelscope.cn/iic/CosyVoice-300M.git pretrained_models/CosyVoice-300M# 下载微调版本git clone https://www.modelscope.cn/iic/CosyVoice-300M-SFT.git pretrained_models/CosyVoice-300M-SFT# 下载另一个版本git clone https://www.modelscope.cn/iic/CosyVoice-300M-Instruct.git pretrained_models/CosyVoice-300M-Instruct# 下载语音合成模型git clone https://www.modelscope.cn/speech_tts/speech_kantts_ttsfrd.git pretrained_models/speech_kantts_ttsfrd

2.3 可能遇到的问题

网络要求高：必须开特殊网络，而且网络不稳定就容易下载中断。断了之后，得手动清理没下完的文件，再重新下载。

文件容易缺：可能有些重要文件没下载下来，等我们用模型的时候就会报错，还得自己检查文件够不够、对不对。

自己装依赖：下完模型，还得手动安装模型运行需要的其他软件，装错版本就用不了。

踩坑笔记：之前尝试这个方法，网络中断后没清理干净残留文件，重新下载就出问题了，折腾好久才解决。下载后可能文件不完整，运行程序时一直报找不到相关文件的错。

三、两种方法对比

对比项	ModelScope SDK 下载	Git LFS 下载
网络	正常网络就能下，断了能续	必须特殊网络，容易断
出错概率	很低	很高
操作难度	复制代码运行就行	要处理各种问题