> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Mage-Flow：ComfyUI 工作流示例

> Mage-Flow 是微软推出的紧凑型 4B 参数生成式模型栈，用于文生图和基于指令的图像编辑。它使用 Mage-VAE 和原生分辨率多模态扩散 Transformer（NR-MMDiT），并结合了整流流匹配（rectified flow matching）。

**Mage-Flow** 是微软研究院推出的一款紧凑型 4B 规模生成式模型栈，用于高效的文生图和基于指令的图像编辑。该模型栈由两个协同设计的组件构成：[Mage-VAE](https://huggingface.co/microsoft/Mage-VAE)（一个轻量级高保真潜在编码器）以及一个通过整流流匹配（rectified flow matching）训练的原生分辨率多模态扩散 Transformer（NR-MMDiT）。结合原生分辨率打包技术，该共享模型栈驱动了两个模型实例：用于文生图的 Mage-Flow 和用于基于指令图像编辑的 Mage-Flow-Edit。每个实例都提供 Base（基础版）、RL-aligned（强化学习对齐版）和 4-step Turbo（4步 Turbo 版）三种变体。

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

**许可证**：[MIT](https://github.com/microsoft/Mage/blob/main/LICENSE)

**相关链接**：

* [Hugging Face：microsoft/Mage-Flow](https://huggingface.co/microsoft/Mage-Flow)
* [Hugging Face：Comfy-Org/Mage-Flow（ComfyUI 模型）](https://huggingface.co/Comfy-Org/Mage-Flow)
* [官方 GitHub 仓库](https://github.com/microsoft/Mage)
* [技术报告（arXiv）](https://arxiv.org/abs/2607.19064)

## Mage-Flow 文生图工作流

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/Mage_flow.png" alt="Mage-Flow 文生图工作流输出" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 中运行" icon="cloud" href="https://cloud.comfy.org/?template=image_mage_flow_t2i_int8&utm_source=docs&utm_medium=referral&utm_campaign=mage-flow">
    在 Comfy Cloud 中打开
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_mage_flow_t2i_int8.json">
    下载 JSON 或在模板库中搜索 "Mage-Flow"
  </Card>
</CardGroup>

<Tip>
  <Tabs>
    <Tab title="本地用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在 ComfyUI 的[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

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

      1. 你用的不是最新开发版（nightly）。
      2. 启动时有些节点导入失败。
    </Tab>

    <Tab title="云端用户">
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新，我们会同步更新 Cloud。

      所以，如果你发现本教程中有任何核心节点缺失，那是因为对应的节点支持还在开发中没有发布正式的稳定版，请等待下一个稳定版本发布。
    </Tab>
  </Tabs>
</Tip>

该工作流分为以下几个部分：

1. **Text to Image（Mage-Flow）子图**：核心生成管线，包含模型加载、提示词处理、原生分辨率潜在空间生成、采样和 VAE 解码
2. **SaveImageAdvanced**：保存生成的图像

<Card title="了解子图" icon="book-open" href="/zh/interface/features/subgraph">
  本工作流使用子图节点实现模块化处理。请查看子图文档，了解如何自定义和扩展工作流。
</Card>

### 一键生成

最简单的用法：在子图中输入文本提示词，设置所需分辨率，然后点击 **Queue Prompt**。默认设置即可在最小配置下生成高质量图像。

### 使用工作流

1. **输入提示词** — 在子图的提示词输入框中输入文本描述
2. **设置分辨率** — 调整宽度和高度以设置所需的输出尺寸。Mage-Flow 支持每边 512 到 2048 像素的原生分辨率
3. **调整设置** — 根据需要配置随机种子（seed）和负向提示词（negative prompt）
4. **点击 Queue** — 按 `Ctrl+Enter` 生成

## Mage-Flow Turbo 文生图工作流

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/Mage_flow_turbo.png" alt="Mage-Flow Turbo 文生图工作流输出" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 中运行" icon="cloud" href="https://cloud.comfy.org/?template=image_mage_flow_turbo_t2i_int8&utm_source=docs&utm_medium=referral&utm_campaign=mage-flow">
    在 Comfy Cloud 中打开
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_mage_flow_turbo_t2i_int8.json">
    下载 JSON 或在模板库中搜索 "Mage-Flow Turbo"
  </Card>
</CardGroup>

Turbo 变体使用蒸馏后的 4 步检查点，在保持高质量的同时实现更快的生成速度。其工作流结构和控制方式与基础文生图工作流完全相同，但使用了 Turbo 扩散模型以实现更低延迟的推理。

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

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/Mage_flow_edit.png" alt="Mage-Flow-Edit 图像编辑工作流输出" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 中运行" icon="cloud" href="https://cloud.comfy.org/?template=image_mage_flow_edit_int8&utm_source=docs&utm_medium=referral&utm_campaign=mage-flow">
    在 Comfy Cloud 中打开
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_mage_flow_edit_int8.json">
    下载 JSON 或在模板库中搜索 "Mage-Flow-Edit"
  </Card>

  <Card title="下载示例图像" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/calm_amid_ruin.png">
    获取本工作流的示例输入图像
  </Card>
</CardGroup>

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

该工作流分为以下几个部分：

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

### 使用图像编辑

1. **上传参考图像** — 使用 **LoadImage** 节点加载你想要编辑的图像（最多 3 张）
2. **输入编辑指令** — 输入文本描述你想要进行的编辑操作（例如："将背景替换为海滩场景" 或 "将其转换为水彩画风格"）
3. **调整设置** — 配置分辨率、随机种子（seed）和其他参数
4. **点击 Queue** — 按 `Ctrl+Enter` 生成

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

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/Mage_flow_edit_turbo.png" alt="Mage-Flow-Edit Turbo 图像编辑工作流输出" />

<CardGroup cols={2}>
  <Card title="在 Comfy Cloud 中运行" icon="cloud" href="https://cloud.comfy.org/?template=image_mage_flow_edit_turbo_int8&utm_source=docs&utm_medium=referral&utm_campaign=mage-flow">
    在 Comfy Cloud 中打开
  </Card>

  <Card title="下载工作流" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_mage_flow_edit_turbo_int8.json">
    下载 JSON 或在模板库中搜索 "Mage-Flow-Edit Turbo"
  </Card>

  <Card title="下载示例图像" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/hot_air_balloons_rising.png">
    获取本工作流的示例输入图像
  </Card>
</CardGroup>

编辑工作流的 Turbo 变体使用蒸馏后的 4 步检查点，实现更快的编辑速度。其结构和控制方式与基础编辑工作流相同，但采样步数更少。

### 模型下载

如需本地使用，请从 [Comfy-Org/Mage-Flow](https://huggingface.co/Comfy-Org/Mage-Flow) 下载 ComfyUI 优化后的模型文件。

<CardGroup cols={3}>
  <Card title="文本编码器" icon="download" href="https://huggingface.co/Comfy-Org/Mage-Flow/resolve/main/text_encoders/qwen3vl_4b_bf16.safetensors">
    qwen3vl\_4b\_bf16.safetensors：Qwen3VL-4B 文本编码器
  </Card>

  <Card title="VAE" icon="download" href="https://huggingface.co/Comfy-Org/Mage-Flow/resolve/main/vae/mage_flow_vae_bf16.safetensors">
    mage\_flow\_vae\_bf16.safetensors
  </Card>

  <Card title="扩散模型（Base Int8）" icon="download" href="https://huggingface.co/Comfy-Org/Mage-Flow/resolve/main/diffusion_models/mage_flow_int8_convrot.safetensors">
    mage\_flow\_int8\_convrot.safetensors：T2I 工作流中使用的基础模型
  </Card>

  <Card title="扩散模型（Turbo Int8）" icon="download" href="https://huggingface.co/Comfy-Org/Mage-Flow/resolve/main/diffusion_models/mage_flow_turbo_int8_convrot.safetensors">
    mage\_flow\_turbo\_int8\_convrot.safetensors：Turbo T2I 工作流中使用的 Turbo 模型
  </Card>

  <Card title="扩散模型（Edit Int8）" icon="download" href="https://huggingface.co/Comfy-Org/Mage-Flow/resolve/main/diffusion_models/mage_flow_edit_int8_convrot.safetensors">
    mage\_flow\_edit\_int8\_convrot.safetensors：编辑工作流中使用的 Edit 模型
  </Card>

  <Card title="扩散模型（Edit Turbo Int8）" icon="download" href="https://huggingface.co/Comfy-Org/Mage-Flow/resolve/main/diffusion_models/mage_flow_edit_turbo_int8_convrot.safetensors">
    mage\_flow\_edit\_turbo\_int8\_convrot.safetensors：Edit Turbo 工作流中使用的 Edit Turbo 模型
  </Card>
</CardGroup>

其他模型变体（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
```