> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mage-Flow：ComfyUI 工作流示例

> Mage-Flow 是微软推出的紧凑型 4B 模型，用于在 ComfyUI 中进行文生图和基于指令的图像编辑，支持最高 2K 的原生分辨率。

**Mage-Flow** 是微软研究院推出的紧凑型 4B 规模生成式技术栈，用于高效的文生图和基于指令的图像编辑。该技术栈由两个协同设计的组件构成：[Mage-VAE](https://huggingface.co/microsoft/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](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)

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

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

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

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

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

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

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

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

### 一键生成

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

### 使用工作流

1. **输入提示词**：在子图的提示词输入框中输入文本描述
2. **设置分辨率**：调整宽度和高度，以获得所需的输出尺寸。Mage-Flow 支持每边 512 至 2048 像素的原生分辨率。
3. **调整设置**：根据需要配置种子和负面提示词
4. **点击队列**：按 `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 步 checkpoint 实现更快的生成，同时保持高质量。工作流结构与基础文生图工作流完全一致，但使用 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. **图像编辑（Mage-Flow-Edit）子图**：核心编辑 pipeline，包含模型加载、参考图像条件、提示词处理和采样
3. **ImageCompare**：并排比较原图与编辑后的图像
4. **SaveImage**：保存编辑后的输出

### 使用图像编辑

1. **上传参考图像**：使用 **LoadImage** 节点加载需要编辑的图像（最多 3 张）
2. **输入编辑指令**：输入想要应用的编辑的文本描述（例如“将背景替换为海滩场景”或“将其变成水彩画”）
3. **调整设置**：配置分辨率、种子和其他参数
4. **点击队列**：按 `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 步 checkpoint 实现更快的编辑。其结构和控件与基础编辑工作流一致，但采样步数更少。

### 模型下载

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

<CardGroup cols={3}>
  <Card title="Text Encoder" 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="Diffusion Model (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="Diffusion Model (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="Diffusion Model (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：编辑工作流中使用的编辑模型
  </Card>

  <Card title="Diffusion Model (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：编辑 Turbo 工作流中使用的编辑 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
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.