texture-fix-vae-for-qwen-image-2.1 Diffusers 快速上手2 行代码替换官方 VAE 的 AI 绘图工作流【免费下载链接】texture-fix-vae-for-qwen-image-2.1项目地址: https://ai.gitcode.com/hf_mirrors/madebyollin/texture-fix-vae-for-qwen-image-2.1texture-fix-vae-for-qwen-image-2.1 是一款专为 Qwen-Image-2.1 图像生成模型微调的 VAE变分自编码器。它只需2 行 Diffusers 代码即可替换官方 VAE专门解决两个困扰创作者的痛点解码时出现棋盘格伪影以及在 fp16 精度下输出NaN 花屏。如果你是 AI 绘图新手本文带你用最简单的方式把它接入现有工作流。快速了解这个 VAE 修复了哪两个问题在 Diffusion 模型中VAE 负责把潜空间latent解码成最终像素。官方 Qwen-Image-2.1 VAE 存在两个已知缺陷而本项目通过少量微调一次性修复问题官方 VAETexture-Fix VAE棋盘格伪影checkerboard artifacts细节区域常见网格状纹理 ❌微调后干净自然 ✅fp16 精度下输出 NaN透明区域大面积花屏最多约 75/185 压测用例失败0 失败支持--fp16-vae✅感知质量 rFIDCOCO越低越好3.382.07 / 2.06 原理一句话官方 VAE 训练时缺少有效的对抗损失GAN loss细节重建不足时就容易出现网格纹理本项目参照 TAESD 的对抗训练配方仅微调最高分辨率的解码器层约 7.5M 可训练参数就消除了伪影。效果对比棋盘格伪影修复前后下面的局部放大图来自仓库内置对比素材——左侧是官方 VAE 解码结果可以看到明显的棋盘格网格纹理右侧是 Texture-Fix VAE 的结果同样的 latents 解码后纹理干净清晰。官方 VAE 放大细节存在棋盘格伪影Texture-Fix VAE 放大细节纹理修复后完整对比说明含生成用的英文提示词见 README.md。Diffusers 最快替换步骤只需 2 行代码如果你用 Hugging Face Diffusers 跑 Qwen-Image-2.1替换官方 VAE 只需加载 Texture-Fix VAE 并传入 pipelineimport torch from diffusers import QwenImage21Pipeline, AutoencoderKLQwenImage21 vae AutoencoderKLQwenImage21.from_pretrained( madebyollin/texture-fix-vae-for-qwen-image-2.1, torch_dtypetorch.bfloat16) pipe QwenImage21Pipeline.from_pretrained( Qwen/Qwen-Image-2.1, vaevae, torch_dtypetorch.bfloat16).to(cuda)就这么简单——VAE 即插即用编码器、采样器和文本编码器全部保持官方不变。也可以直接用 fp16 加载避免官方 VAE 的 NaN 问题。ComfyUI 中使用 Texture-Fix VAE 的方法ComfyUI 用户不需要写代码只需替换模型文件下载 texture_fix_vae_for_qwen_image_2.1_bf16.safetensors放入ComfyUI/models/vae/目录替换原来的qwen_image_2.1_vae_bf16.safetensors在Load VAE节点中选择它即可搭配--fp16-vae启动参数同样可用。如需离线克隆整个仓库可用git clone https://gitcode.com/hf_mirrors/madebyollin/texture-fix-vae-for-qwen-image-2.1质量指标与文件资料一览官方 VAE 在重建精度PSNR/LPIPS上略占优而 Texture-Fix VAE 在感知质量rFID上明显更好——也就是人眼看起来更自然。对出图质量而言后者通常更重要。文件说明config.jsonVAE 配置类名为AutoencoderKLQwenImage21含 latents 均值/标准差texture_fix_vae_for_qwen_image_2.1_bf16.safetensorsbf16 权重文件ComfyUI 直接使用fp16_demo.pyfp16 NaN 对比复现脚本可生成花屏对比图README.md官方文档原理、指标、版本历史新手常见问题 FAQ替换后会有画质损失吗PSNR/LPIPS 略有下降如 COCO 上 PSNR 从 33.29 降至 32.73但 rFID 从 3.38 降到 2.07感知质量更高。综合体验是细节更锐利、无网格纹理。我的显存小能用 fp16 吗可以这正是本项目的强项185 个压测输入含透明图、随机 latents中官方 VAE 有 75 个产生 NaN 输出Texture-Fix VAE 为0。复现方法见 fp16_demo.py。我可以商用吗本项目基于 Qwen-Image-2.1遵循 Qwen 研究许可协议仅限非商业/研究用途详见 LICENSE 与 NOTICE。总结如果你正在用 Qwen-Image-2.1 做 AI 绘图却被棋盘格伪影或 fp16 花屏困扰texture-fix-vae-for-qwen-image-2.1 是即插即用的解法Diffusers 用户 2 行代码、ComfyUI 用户替换一个文件就能获得更干净的纹理和更稳的 fp16 运行。【免费下载链接】texture-fix-vae-for-qwen-image-2.1项目地址: https://ai.gitcode.com/hf_mirrors/madebyollin/texture-fix-vae-for-qwen-image-2.1创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考