ComfyUI MOSS Image

非官方指南 · 2026-10-21 核对

ComfyUI MOSS-Image 安装指南

在 ComfyUI 里运行 OpenMOSS 的 5B 模型 MOSS-Image：要下载哪三个文件、放进哪个文件夹、什么显存用什么版本，以及最先遇到的报错怎么解决。

按显存选文件排查报错
  • 5B DiT · Qwen3.5-9B 文本编码器
  • Apache-2.0 开源
  • 2026-10-16 发布
  • ComfyUI v0.42.0 起原生支持
  • 能渲染中英文文字

在 ComfyUI 里装好 MOSS-Image

原生支持，不用装自定义节点，四步完成。

  1. 1

    把 ComfyUI 更新到 v0.42.0 或更新版本

    支持代码 10-16 合入（提交 e087d8f6），10-18 发布的 v0.42.0 是第一个包含它的正式版。ComfyUI 文档写的是 0.41.3 就够，但 0.41.3 里没有这次改动，会报「Could not detect model type」。

  2. 2

    下载三个文件

    扩散模型、Qwen3.5-9B 文本编码器和 FLUX.2 VAE，都在 Hugging Face 的 Comfy-Org/MOSS-Image 仓库。模板默认的一套约 13 GB，具体文件见下方的选择器。

  3. 3

    打开官方模板

    打开模板库，搜索「MOSS-Image」。一共四个：文生图和按版面生成，各分 SFT 和 Base 两版。

  4. 4

    写提示词，运行

    描述成图本身，不要写成给模型的要求。提示词扩写默认开启，会用同一个文本编码器把短提示词扩写成完整描述；想原样发送，把 enable_prompt_upsampler 设为 false。

完整安装教程

来源： ComfyUI PR #17095 · ComfyUI v0.42.0 · OpenMOSS ComfyUI README · docs.comfy.org

按显存选文件

选好模型和显存，下面列出要下载的文件、每个文件放进哪个文件夹，以及对应的下载命令。

模型
显存

用模板默认的一套：int8 模型、w4a8 文本编码器、小号 VAE。显存不够时 ComfyUI 会把一部分挪到内存，所以 6–8 GB 的卡也能跑，只是更慢。

扩散模型

moss_image_sft_int8_convrot.safetensors

放到 ComfyUI/models/diffusion_models/下载：Hugging FaceModelScope
文本编码器

qwen3.5_9b_w4a8_gptq.safetensors

放到 ComfyUI/models/text_encoders/下载：Hugging FaceModelScope
VAE

flux2-vae_small.safetensors

放到 ComfyUI/models/vae/下载：Hugging FaceModelScope
合计下载13.01 GB
下载命令
hf download Comfy-Org/MOSS-Image diffusion_models/moss_image_sft_int8_convrot.safetensors --local-dir ComfyUI/models
hf download Comfy-Org/MOSS-Image text_encoders/qwen3.5_9b_w4a8_gptq.safetensors --local-dir ComfyUI/models
hf download Comfy-Org/MOSS-Image vae/flux2-vae_small.safetensors --local-dir ComfyUI/models

在 ComfyUI 文件夹的上一级目录运行。需要先安装 Hugging Face 命令行：pip install -U huggingface_hub。

国内访问 Hugging Face 慢或打不开时，用上面的 ModelScope 链接（文件完全相同），或先设置环境变量 HF_ENDPOINT=https://hf-mirror.com 再运行命令。

官方没有公布显存要求。这里的建议依据文件大小和 ComfyUI 的自动卸载机制。

Comfy-Org 仓库全部文件

文件大小ComfyUI 文件夹
moss_image_sft_int8_convrot.safetensorsModelScope模板默认5.41 GBComfyUI/models/diffusion_models/
moss_image_sft_bf16.safetensorsModelScope10.16 GBComfyUI/models/diffusion_models/
moss_image_base_int8_convrot.safetensorsModelScope模板默认5.41 GBComfyUI/models/diffusion_models/
moss_image_base_bf16.safetensorsModelScope10.16 GBComfyUI/models/diffusion_models/
qwen3.5_9b_w4a8_gptq.safetensorsModelScope模板默认7.34 GBComfyUI/models/text_encoders/
qwen3.5_9b_int8_convrot.safetensorsModelScope9.75 GBComfyUI/models/text_encoders/
qwen3.5_9b_bf16.safetensorsModelScope19.31 GBComfyUI/models/text_encoders/
flux2-vae_small.safetensorsModelScope模板默认0.25 GBComfyUI/models/vae/
flux2-vae.safetensorsModelScope0.34 GBComfyUI/models/vae/

来源： Comfy-Org/MOSS-Image · docs.comfy.org · Comfy-Org discussion #4

官方工作流与参数

四个模板共用同一个子图。可以在本站工作流页复制到 ComfyUI，也可以在模板库里直接打开。

复制或下载工作流

推荐参数

参数ComfyUI 模板OpenMOSS 官方
步数2550 及以上
CFG2.53（范围 3–6，提示词短就调高）
采样器er_sdeEuler（流匹配）
Shift5（模型默认）5
跳层引导（SLG）开启，第 22 层第 22 层
分辨率默认 1 MP1–2 MP，宽高为 16 的倍数
  • 要改 shift，用 ModelSamplingAuraFlow。ModelSamplingSD3 配 int8 模型会报 dtype 错误。
  • 关掉跳层引导，画面可能更写实，但细节可能塌掉。

来源： docs.comfy.org · OpenMOSS ComfyUI README · OpenMOSS user guide

版面 JSON 怎么写

MOSS-Image 能把文字和物体放进你指定的框里。在 ComfyUI 里，用 Create Bounding Boxes 画框，MOSS-Image Layout Prompt 节点会把框转换成这种 JSON。

bbox 的格式是 [y_min, x_min, y_max, x_max]，单位是像素，原点在画布中心（bbox_coord_space 为「abs_centralized」）。1024×1024 的画布上，每个方向从 −512 到 512，x 向右增大，y 向下增大。换算普通的左上角坐标时，x 减去宽度的一半，y 减去高度的一半。

每个元素有 label（text、character 或 object）、caption 和 bbox；文字元素还要写上要渲染的 text。框的坐标要和输出尺寸一致。

官方示例（1024×1024）
{
  "summary": {
    "meta": ["poster"],
    "canvas": "single",
    "caption": "A minimalist travel poster with a cream background, a blue mountain illustration, and the title EXPLORE at the top."
  },
  "items": [
    {
      "label": "text",
      "caption": "Large dark-blue uppercase title centered at the top.",
      "text": "EXPLORE",
      "bbox": [-416, -384, -288, 384]
    },
    {
      "label": "object",
      "caption": "A flat blue mountain illustration in the lower center.",
      "bbox": [-192, -288, 384, 288]
    }
  ],
  "bbox_coord_space": "abs_centralized",
  "bbox_format": "yxyx"
}

来源： OpenMOSS/MOSS-Image README · OpenMOSS user guide · docs.comfy.org

常见报错与解决

整理自 Comfy-Org 和 OpenMOSS 的讨论区与 issue。

报「Could not detect model type」，或者 CLIP 类型里没有 moss_image

ComfyUI 版本低于 v0.42.0，0.41.3 不支持 MOSS-Image。更新到 v0.42.0 及以上，或者用 nightly。不要把 CLIP 类型改成 Flux 2。

按版面生成的模板下载错了模型

官方 SFT 版面模板里，moss_image_sft_int8_convrot.safetensors 的下载链接指向的是 Base 文件。如果你是通过它下载的，请直接下载 moss_image_sft_int8_convrot.safetensors。本站提供的工作流已改正这个链接。

用 int8 模型时 KSampler 报 dtype 错误

工作流里接了 ModelSamplingSD3 节点，换成 ModelSamplingAuraFlow 或 ModelSamplingFlux。

要装哪些自定义节点？

不用装。Comfy-Org 的文件用核心节点就能跑。OpenMOSS 的插件只用来加载 Hugging Face / Diffusers 格式的目录。

AttributeError: 'NoneType' object has no attribute 'dtype'

OpenMOSS 插件的加载节点读不了 Comfy-Org 的单文件模型，改用核心的 Load Diffusion Model 节点加载。

有 GGUF 版本吗？

Comfy-Org 不提供，推荐用 int8 加自动卸载。社区有人做了 GGUF，例如 realrebelai/MOSS-Image_GGUFs。

SFT 出图有竖向色带

官方 README 里列出的社区 LoRA MATLOWAI/MOSS-Image-SFT-DeBand 可以减轻色带。

加了 TorchCompileModel 之后工作流出错

它和跳层引导的补丁冲突，去掉 torch.compile 直接运行。

同一个种子，出图和 Python 管线不一样

正常现象。ComfyUI 的调度器取整方式不同，种子无法完全复现独立管线的结果。

来源： Comfy-Org discussion #6 · Comfy-Org discussion #4 · OpenMOSS issue #10 · OpenMOSS ComfyUI README · OpenMOSS/MOSS-Image README

常见问题

简短回答，依据见本页各节的来源链接。

可以开始了

把 ComfyUI 更新到 v0.42.0 或更新版本，下载三个文件，打开 MOSS-Image 模板。

去选文件