ComfyPilotComfyPilot
文档 / 教程 / Mage-Flow：ComfyUI 文生图与指令式图像编辑

Mage-Flow：ComfyUI 文生图与指令式图像编辑

在 ComfyUI 中运行微软 4B 的 Mage-Flow：文生图生成与基于指令的图像编辑，原生分辨率最高支持 2K。

教程 mage-flow 更新于 2026-10-27

查看官方原文

Mage-Flow：ComfyUI 文生图与指令式图像编辑

在 ComfyUI 中运行微软 4B 的 Mage-Flow：文生图生成与基于指令的图像编辑，原生分辨率最高支持 2K。

Mage-Flow 是微软研究院推出的紧凑型 4B 规模生成式技术栈，用于高效的文生图和基于指令的图像编辑。该技术栈由两个协同设计的组件构成：Mage-VAE（一个轻量级高保真度 Latent tokenizer）和采用整流流匹配（rectified flow matching）训练的原生分辨率多模态扩散 Transformer（NR-MMDiT）。结合原生分辨率打包，该共享技术栈为两个模型实例提供支持：用于文生图的 Mage-Flow 和用于基于指令的图像编辑的 Mage-Flow-Edit。每个实例提供 Base、RL 对齐和 4 步 Turbo 三种变体。

Mage-Flow 支持每边 512 到 2048 像素的原生分辨率，并支持任意宽高比，包括 4:1 等极端尺寸。

许可证：MIT

相关链接：

Mage-Flow 文生图工作流

Mage-Flow 文生图工作流输出

[card] 在 Comfy Cloud 上运行 在 Comfy Cloud 中打开
[card] 下载工作流 下载 JSON 或在模板库中搜索 “Mage-Flow”
[!TIP] > [tab] 本地用户 > > 请确保你的 ComfyUI 已经更新。 > > ComfyUI 下载 > ComfyUI 更新教程 > > 本指南里的工作流可以在工作流模板中找到。如果找不到，可能是 ComfyUI 没有更新。 > > 如果加载工作流时有节点缺失，可能原因有： > > 1. 你用的不是最新版（每夜版）。 > 2. 启动时有些节点导入失败。 > [tab] 云端用户 > > * Cloud 会在 ComfyUI 稳定版本发布后更新。 > > 所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。

该工作流由以下几个部分组成：

  1. 文生图（Mage-Flow）子图：核心生成 pipeline，包含模型加载、提示词处理、原生分辨率 Latent 生成、采样和 VAE解码
  2. SaveImageAdvanced：保存已生成的图像
[card] 了解 Subgraph 此工作流使用 Subgraph 节点进行模块化处理。请查阅 Subgraph 文档，了解如何自定义和扩展此工作流。

一键生成

最简单的方式是：在子图中输入文本提示词，设置所需分辨率，然后点击 执行提示词。默认参数即可生成高质量图像，几乎无需额外配置。

使用工作流

  1. 输入提示词：在子图的提示词输入框中输入文本描述
  2. 设置分辨率：调整宽度和高度，以获得所需的输出尺寸。Mage-Flow 支持每边 512 至 2048 像素的原生分辨率。
  3. 调整设置：根据需要配置种子和负面提示词
  4. 点击队列：按 Ctrl+Enter 生成

Mage-Flow Turbo 文生图工作流

Mage-Flow Turbo 文生图工作流输出

[card] 在 Comfy Cloud 上运行 在 Comfy Cloud 中打开
[card] 下载工作流 下载 JSON 或在模板库中搜索 “Mage-Flow Turbo”

Turbo 变体使用蒸馏的 4 步 checkpoint 实现更快的生成，同时保持高质量。工作流结构与基础文生图工作流完全一致，但使用 Turbo 扩散模型以获得更低的推理延迟。

Mage-Flow-Edit 图像编辑工作流

Mage-Flow-Edit 图像编辑工作流输出

[card] 在 Comfy Cloud 上运行 在 Comfy Cloud 中打开
[card] 下载工作流 下载 JSON 或在模板库中搜索 “Mage-Flow-Edit”
[card] 下载示例图像 获取此工作流的示例输入图像

图像编辑工作流使用 Mage-Flow-Edit，这是一个基于指令的模型，可通过自然语言描述编辑图像。上传一张或多张参考图像，并描述期望的编辑效果。

该工作流由以下几个部分组成：

  1. LoadImage：上传参考图像（最多 3 张）
  2. 图像编辑（Mage-Flow-Edit）子图：核心编辑 pipeline，包含模型加载、参考图像条件、提示词处理和采样
  3. ImageCompare：并排比较原图与编辑后的图像
  4. SaveImage：保存编辑后的输出

使用图像编辑

  1. 上传参考图像：使用 LoadImage 节点加载需要编辑的图像（最多 3 张）
  2. 输入编辑指令：输入想要应用的编辑的文本描述（例如“将背景替换为海滩场景”或“将其变成水彩画”）
  3. 调整设置：配置分辨率、种子和其他参数
  4. 点击队列：按 Ctrl+Enter 生成

Mage-Flow-Edit Turbo 图像编辑工作流

Mage-Flow-Edit Turbo 图像编辑工作流输出

[card] 在 Comfy Cloud 上运行 在 Comfy Cloud 中打开
[card] 下载工作流 下载 JSON 或在模板库中搜索 “Mage-Flow-Edit Turbo”
[card] 下载示例图像 获取此工作流的示例输入图像

编辑工作流的 Turbo 变体使用蒸馏的 4 步 checkpoint 实现更快的编辑。其结构和控件与基础编辑工作流一致，但采样步数更少。

模型下载

如需本地使用，请从 Comfy-Org/Mage-Flow 下载 ComfyUI 优化版模型文件。

[card] Text Encoder qwen3vl\_4b\_bf16.safetensors：Qwen3VL-4B 文本编码器
[card] VAE mage\_flow\_vae\_bf16.safetensors
[card] Diffusion Model (Base Int8) mage\_flow\_int8\_convrot.safetensors：T2I 工作流中使用的基础模型
[card] Diffusion Model (Turbo Int8) mage\_flow\_turbo\_int8\_convrot.safetensors：Turbo T2I 工作流中使用的 Turbo 模型
[card] Diffusion Model (Edit Int8) mage\_flow\_edit\_int8\_convrot.safetensors：编辑工作流中使用的编辑模型
[card] Diffusion Model (Edit Turbo Int8) mage\_flow\_edit\_turbo\_int8\_convrot.safetensors：编辑 Turbo 工作流中使用的编辑 Turbo 模型

其他模型变体（BF16、FP8）也可供不同硬件配置的用户使用。

将文件放入以下目录：

📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   ├── mage_flow_int8_convrot.safetensors
│   │   ├── mage_flow_turbo_int8_convrot.safetensors
│   │   ├── mage_flow_edit_int8_convrot.safetensors
│   │   └── mage_flow_edit_turbo_int8_convrot.safetensors
│   ├── 📂 text_encoders/
│   │   └── qwen3vl_4b_bf16.safetensors
│   └── 📂 vae/
│       └── mage_flow_vae_bf16.safetensors