下载模型时必须记住的四项:仓库、修订、路径与校验依据
同一个模型名称可能对应整包 checkpoint、分体权重、量化版、文本编码器和 VAE。此文提供下载记录与核对步骤,避免文章只留一个搜索链接,后来无法确定实际使用哪个文件。
用途与适用范围
同一个模型名称可能对应整包 checkpoint、分体权重、量化版、文本编码器和 VAE。此文提供下载记录与核对步骤,避免文章只留一个搜索链接,后来无法确定实际使用哪个文件。
已核对的依据
Hugging Face Hub 下载 API 支持指定 revision 与单文件路径,并区分缓存和 local_dir。原作者没有给出可靠校验值时,文件名与大小只能作为线索,不能当成完整性证明。 P11 P10 D03
开始前需要分清的事项
1. 从工作流明确需要的资源出发,区分 diffusion、text encoder、VAE、LoRA 和自定义节点代码。
2. 记录原作者或转换者、对应模型家族和使用限制来源。
3. 确认本地空间、受限仓库资格及下载工具身份。
操作与检查步骤
以下步骤是基于所列资料编排的操作建议;具体文件、版本和运行环境仍需按实际项目核对。
第 1 步。 建立一行一文件的清单,至少保存 provider、repo、revision、relative path 与目标目录;未确认版本写未知。
第 2 步。 优先从正式发布入口获取,按需选择文件而不是默认下载整个仓库;不要将下载网页另存为权重。
第 3 步。 记录下载后大小,有可靠上游 SHA256 等信息时进行同算法比较;仅本地计算出哈希不能独立证明来自原作者。
第 4 步。 加载前核对所选节点、精度与配套模型,保存核对日期与未确认项。换版本时保留旧身份而不是直接覆盖记录。
完成后的检查
能够从记录追溯到具体文件,并区分“下载完成”“完整性比对”“加载成功”和“工作流执行成功”四种状态。
注意事项与尚未确认的部分
不要修改 Hub 缓存中的文件本体,也不要把私人 token 填入公开文章。跨平台镜像只有在可靠内容身份一致时才可标为相同文件。
资料核对日期:2026-09-21。本站未执行此工作流,未进行 GPU、最低显存或耗时测试。
原始资料
- P11 · Hugging Face Hub download guide。核对:2026-09-21。
- P10 · Hugging Face gated models。核对:2026-09-21。
- D03 · ComfyUI model troubleshooting。核对:2026-09-21。
相关排查与操作
这篇内容对你有帮助吗?
匿名统计,只记录“有/没有帮助”的计数,不记录账号、IP 地址或设备信息。
资料来源
基于上游文档、源代码或标注为个案的错误报告整理。诊断顺序由本站编排;没有执行、硬件测试或保证修复的结论。
01Hugging Face Hub download guide资料核对: 2026-09-2102Hugging Face gated models资料核对: 2026-09-2103ComfyUI model troubleshooting资料核对: 2026-09-21报告问题 · 8ebf63ac-2955-538c-8169-741c35737669
相关阅读
编辑为本页关联的条目。
日志关键词: HeaderTooLarge
加载 .safetensors 时解析头部失败。常见排查方向包括下载内容不正确、传输不完整、实际格式不同及加载器版本,但这条错误本身不能唯一证明文件损坏。
日志关键词: 401 Client Error
浏览器可以打开模型页面,但命令行、节点或下载脚本得到未授权或拒绝访问。这里首先检查资源访问资格与凭据身份,不应直接关闭 TLS 校验或寻找绕过受限仓库的方法。
多个 ComfyUI 实例可以按支持的配置引用已有模型目录,但共享文件不代表共享了 Python 环境、节点安装和工作流版本。本页重点解决“模型明明在磁盘上,当前实例却找不到”。