跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

AI 绘画报错修复:CheckpointLoaderSimple 模型缺失处理

针对 AI 绘画中 CheckpointLoaderSimple 报错及模型缺失问题,需确认本地 models/checkpoints 目录是否包含指定名称的 safetensors 文件。通过 HuggingFace 下载 v1-5-pruned-emaonly 主模型及 vae-ft-mse-840000-ema-pruned VAE 文件,分别放入 checkpoints 和 vae 目录即可解决。初始生成效果不佳属正常情况,持续调试优化参数可改善结果。

DockerOne发布于 2026/3/21更新于 2026/9/860 浏览

报错定位

在运行过程中,控制台抛出 CheckpointLoaderSimple 异常,明确指出 ckpt_name 的值不在可用列表中。简单来说,就是代码想找的文件,你文件夹里没有,或者名字对不上。

资源准备

要解决这个问题,得把缺少的模型补全。首先是基础模型 v1-5-pruned-emaonly-fp16.safetensors。 下载地址:https://huggingface.co/runwayml/stable-diffusion-v1-5/tree/main 进去后找到同名文件点击下载。

部署步骤

  1. 把下载好的模型文件放进 models/checkpoints 文件夹。
  2. 别忽略了 VAE,它影响出图颜色。去这里下载 vae-ft-mse-840000-ema-pruned.safetensors:https://huggingface.co/stabilityai/sd-vae-ft-mse-original/tree/main。
  3. 放到 models/vae 目录下。

后续建议

环境配好后,第一次跑出来的图可能不尽如人意,别急着放弃。随着参数调整和模型切换,很快就能跑出高质量作品。

目录

  1. 报错定位
  2. 资源准备
  3. 部署步骤
  4. 后续建议

更多推荐文章

查看全部
  • Java 注解与反射实战:自定义日志与参数校验注解实现
  • ConcurrentHashMap JDK 7/8 底层原理与实现细节
  • LLM 大模型原理详解:词向量、Transformer 与训练机制
  • LLaMA Factory 核心原理讲解
  • 2024 年常见 Redis 面试题:同步机制详解
  • Python 基础语法总结
  • FPGA 验证:全方位解析 AXI Verification IP (AXI VIP)
  • OpenManus 开源 AI Agent 核心架构与工具链解析
  • 6 个 Python 办公自动化技巧:PDF 解析、邮件发送与数据分析实战
  • AI 网络技术编程测试:从理论到实践
  • DeepSeek-R1 大模型基于 MS-Swift 框架的部署、推理与微调实践
  • ComfyUI v0.11.1 发布:新增开发者节点、API 强化与 Python 3.14 兼容
  • Spring Boot 从入门到实战开发指南
  • Spring Boot 集成 MyBatis 操作数据库详解
  • 算法实战:位运算解决字符唯一性与丢失数字问题
  • JavaScript 中 for...in 与 for...of 的区别与用法
  • Seata XA 模式:强一致性分布式事务的配置与权衡
  • 树中所有节点到其他节点的距离之和
  • Lit-LLaMA 大语言模型部署与微调指南
  • C++11 核心特性:列表初始化与右值引用移动语义详解

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online