前提条件
- 安装
modelscope包:
pip install modelscope- 默认下载位置:
~/.cache/modelscope/hub，若要调整，需要设置环境变量：MODELSCOPE_CACHE，macOS 在~/.zshrc中添加：
export MODELSCOPE_CACHE=/path/to/your/cache-
<model_id>模型 ID，从模型首页获取，由组织名称和模型名称组成，如：Qwen/Qwen-Image-2.1； -
下载私有模型需要登陆；
下载指定文件到指定目录
modelscope download --model=<model_id> 'transformer/diffusion_pytorch_model-00001-of-00002.safetensors' --local_dir=/path/to/your/output-
会保留仓库的目录结构，相对路径与远程一致；
-
多个文件用空格分开；
下载完整仓库到默认 cache
modelscope download --model=<model_id>下载完整仓库到指定目录
modelscope download --model=<model_id> --local_dir=/path/to/your/output参数说明
| 参数 | 简写 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
repo_id | - | str | - | 位置参数，仓库 ID（可选，也可通过 --model 指定） |
files | - | str | - | 位置参数，指定要下载的文件（支持多个） |
--model | - | str | None | 模型 ID（与 --dataset 互斥） |
--dataset | - | str | None | 数据集 ID（与 --model 互斥） |
--repo-type | - | choice | model | 仓库类型（model/dataset），与位置参数 repo_id 配合使用 |
--revision | - | str | None | 版本/分支/tag |
--cache_dir | - | str | None | 缓存目录 |
--local_dir | - | str | None | 本地目录（优先于 cache_dir） |
--include | - | list | None | 包含的文件 glob 模式 |
--exclude | - | list | None | 排除的文件 glob 模式 |
--token | - | str | None | 访问令牌（私有模型需要） |
--endpoint | - | str | None | ModelScope 服务端点 |
--max-workers | - | int | 默认 | 最大并发下载线程数 |