Mage-Flow：ComfyUI 工作流示例

Mage-Flow 是微软推出的紧凑型 4B 模型，用于在 ComfyUI 中进行文生图和基于指令的图像编辑，支持最高 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

相关链接：

• Hugging Face：microsoft/Mage-Flow
• Hugging Face：Comfy-Org/Mage-Flow（ComfyUI 模型）
• 官方 GitHub 仓库
• 技术报告（arXiv）

​

Mage-Flow 文生图工作流

在 Comfy Cloud 上运行

在 Comfy Cloud 中打开

下载工作流

下载 JSON 或在模板库中搜索 “Mage-Flow”

本地用户

请确保你的 ComfyUI 已经更新。

• ComfyUI 下载
• ComfyUI 更新教程

本指南里的工作流可以在工作流模板中找到。如果找不到，可能是 ComfyUI 没有更新。

如果加载工作流时有节点缺失，可能原因有：

1. 你用的不是最新版（每夜版）。
2. 启动时有些节点导入失败。

云端用户

• Cloud 会在 ComfyUI 稳定版本发布后更新。

所以，如果你发现本文档中有任何核心节点缺失，可能是因为新核心节点尚未在最新稳定版中发布。请等待下一个稳定版发布。

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

1. 文生图（Mage-Flow）子图：核心生成 pipeline，包含模型加载、提示词处理、原生分辨率 Latent 生成、采样和 VAE解码
2. SaveImageAdvanced：保存已生成的图像

了解 Subgraph

此工作流使用 Subgraph 节点进行模块化处理。请查阅 Subgraph 文档，了解如何自定义和扩展此工作流。

​

一键生成

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

​

使用工作流

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

​

Mage-Flow Turbo 文生图工作流

在 Comfy Cloud 上运行

在 Comfy Cloud 中打开

下载工作流

下载 JSON 或在模板库中搜索 “Mage-Flow Turbo”

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

​

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

在 Comfy Cloud 上运行

在 Comfy Cloud 中打开

下载工作流

下载 JSON 或在模板库中搜索 “Mage-Flow-Edit”

下载示例图像

获取此工作流的示例输入图像

图像编辑工作流使用 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 图像编辑工作流

在 Comfy Cloud 上运行

在 Comfy Cloud 中打开

下载工作流

下载 JSON 或在模板库中搜索 “Mage-Flow-Edit Turbo”

下载示例图像

获取此工作流的示例输入图像

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

​

模型下载

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

Text Encoder

qwen3vl_4b_bf16.safetensors：Qwen3VL-4B 文本编码器

VAE

mage_flow_vae_bf16.safetensors

Diffusion Model (Base Int8)

mage_flow_int8_convrot.safetensors：T2I 工作流中使用的基础模型

Diffusion Model (Turbo Int8)

mage_flow_turbo_int8_convrot.safetensors：Turbo T2I 工作流中使用的 Turbo 模型

Diffusion Model (Edit Int8)

mage_flow_edit_int8_convrot.safetensors：编辑工作流中使用的编辑模型

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