> ## 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 Workflow Example

> Mage-Flowは、Microsoft製のコンパクトな4Bモデルで、ComfyUIでテキストから画像への生成と指示ベースの画像編集を実現します。最大2Kのネイティブ解像度に対応。

**Mage-Flow** は、効率的なテキストから画像への生成と指示ベースの画像編集のためにMicrosoft Researchが開発した、コンパクトな4Bスケールの生成スタックです。このスタックは、共同設計された2つのコンポーネント、すなわち軽量で高忠実度の潜在トークナイザーである [Mage-VAE](https://huggingface.co/microsoft/Mage-VAE) と、整流フロー・マッチングでトレーニングされたネイティブ解像度のマルチモーダルDiffusion Transformer (NR-MMDiT) で構成されています。この共有スタックは、ネイティブ解像度パッキングとともに、テキストから画像への生成用のMage-Flowと、指示ベースの画像編集用のMage-Flow-Editという2つのモデル実装を実現します。各モデルは、Base、RLアライメント済み、4ステップTurboの各バリアントで提供されます。

Mage-Flowは、4:1のような極端な寸法を含む、任意のアスペクト比で各辺512〜2048ピクセルのネイティブ解像度をサポートします。

**ライセンス**: [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)
      * [更新手順](/ja/installation/update_comfyui)

      このガイドで紹介するワークフローは、[ワークフローテンプレート](/ja/interface/features/template)から入手できます。
      テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。

      ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：

      1. 最新の ComfyUI（Nightly 版）を使用していない
      2. 起動時に一部のノードのインポートに失敗している
    </Tab>

    <Tab title="クラウドユーザー">
      * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。

      したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。
    </Tab>
  </Tabs>
</Tip>

ワークフローはいくつかの部分で構成されています：

1. **Text to Image (Mage-Flow) サブグラフ**：モデルの読み込み、プロンプト処理、ネイティブ解像度での潜在生成、サンプリング、VAEデコードを含む中核となる生成パイプライン
2. **SaveImageAdvanced**：生成済み画像を保存

<Card title="サブグラフについて学ぶ" icon="book-open" href="/ja/interface/features/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 diffusion モデルを使用します。

## 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つ以上の参照画像をアップロードし、希望する編集内容を説明します。

ワークフローはいくつかのパートで構成されています:

1. **LoadImage**: 参照画像をアップロードします（最大3枚）
2. **Image Edit（Mage-Flow-Edit）サブグラフ**: モデルの読み込み、参照画像の条件付け、プロンプト処理、サンプリングを含むコア編集パイプライン
3. **ImageCompare**: オリジナル画像と編集後画像を並べて比較します
4. **SaveImage**: 編集後の出力を保存します

### 画像編集の使用方法

1. **参照画像をアップロード**: **LoadImage** ノードを使用して、編集したい画像を読み込みます（最大3枚）
2. **編集指示を入力**: 適用したい編集内容のテキストによる説明を入力します（例：「背景をビーチシーンに置き換える」、「これを水彩画にする」）
3. **設定を調整**: 解像度、シード、その他のパラメータを設定します
4. **キューをクリック**: `Ctrl+Enter` を押して生成します

## Mage-Flow-Edit Turbo image edit workflow

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/Mage_flow_edit_turbo.png" alt="Mage-Flow-Edit Turbo image edit workflow output" />

<CardGroup cols={2}>
  <Card title="Run on 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">
    Open in Comfy Cloud
  </Card>

  <Card title="Download Workflow" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_mage_flow_edit_turbo_int8.json">
    Download JSON or search "Mage-Flow-Edit Turbo" in Template Library
  </Card>

  <Card title="Download Sample Image" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/hot_air_balloons_rising.png">
    Get the example input image for this workflow
  </Card>
</CardGroup>

The Turbo variant of the edit workflow uses a distilled 4-step checkpoint for faster editing. The structure and controls match the base edit workflow but with reduced sampling steps.

### Model downloads

For local use, download the ComfyUI-optimized model files from [Comfy-Org/Mage-Flow](https://huggingface.co/Comfy-Org/Mage-Flow).

<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 text encoder
  </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: Base model used in the T2I workflow
  </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 model used in the Turbo T2I workflow
  </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: Edit model used in the Edit workflow
  </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: Edit Turbo model used in the Edit Turbo workflow
  </Card>
</CardGroup>

Other model variants (BF16, FP8) are also available for users with different hardware configurations.

Place the files in the following directories:

```
📂 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
```