> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-claude-comfy-concurrency-limits-page-s84u33.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Qwen-Image-2.1 ComfyUI ネイティブワークフロー例

> ComfyUI で Qwen-Image-2.1 を実行: 画像生成と編集を 1 つのモデルで行い、ネイティブ 2K 出力、プロフェッショナルなタイポグラフィ、アルファチャンネルのサポートを実現します。

**Qwen-Image-2.1** は、Alibaba の Qwen チームによる Qwen-Image シリーズの最新のオープンウェイトリリースです。単一のモデルがテキストから画像への生成と指示ベースの画像編集の両方をカバーし、ネイティブ 2K 出力、プロフェッショナルなタイポグラフィ、透明な背景のためのアルファチャンネルを備えています。

**主な機能**:

* **1 つのモデルで生成と編集**: 同じ重みがテキストから画像へのプロンプトと編集指示の両方に対応するため、ワークフローでチェックポイントを切り替える必要がありません
* **ネイティブ 2K 出力**: 小さい結果をアップスケーリングするのではなく、最大 2048x2048 で直接生成できます
* **プロフェッショナルなタイポグラフィ**: 高密度の小さなテキストや複雑なレイアウトも維持されるため、インフォグラフィック、スライド、UI モックアップ、ポスター、パッケージデザインに適しています
* **アルファチャンネルのサポート**: VAE が 4 つのチャンネルを持つため、透明な背景の画像を直接生成および編集でき、後から切り抜く必要がありません
* **マルチ画像編集**: 参照画像はスロットの順序でテキストエンコーダーに結合されます。Text Encode Qwen Image 2.1 ノードは最大 16 スロット（`image_1` から `image_16`）を受け付け、このページの 2 つの編集テンプレートは最初の 10 個（`image_1` から `image_10`）を接続しています。`image_1` は編集対象の画像で、残りは内容を補うためのものです。プロンプトはインデックスでそれらを参照します。たとえば `image_1` は `<image1>` と記述します
* **ローカル編集**: 変更したいオブジェクトや領域を記述すると、画像の残りの部分は保持されます

**関連リンク**:

* [GitHub リポジトリ](https://github.com/QwenLM/Qwen-Image)
* [Hugging Face（ComfyUI サポート）](https://huggingface.co/Comfy-Org/Qwen-Image-2.1)
* [Comfy の Qwen Image 2.1](https://comfy.org/qwen-image-2.1/)

## Qwen-Image-2.1 ワークフロー

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

<h3 id="image_qwen_image_2_1_t2i">
  Qwen Image 2.1 テキストから画像へ
</h3>

選択したアスペクト比とメガピクセル数に合わせて、テキストプロンプトから画像を生成します。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_qwen_image_2_1_t2i-1.webp" alt="Qwen-Image-2.1 テキストから画像へのワークフローのプレビュー" />

<CardGroup cols={2}>
  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_qwen_image_2_1_t2i.json">
    JSON をダウンロードするか、テンプレートライブラリで「Qwen-Image-2.1」を検索してください
  </Card>

  <Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=image_qwen_image_2_1_t2i&utm_source=docs&utm_medium=referral&utm_campaign=qwen-image-2-1">
    セットアップ不要で ComfyUI をオンライン実行
  </Card>
</CardGroup>

**出力例**

![Qwen-Image-2.1 テキストから画像への出力例](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_qwen_image_2_1_t2i.png)

<h3 id="image_qwen_image_2_1_image_edit">
  Qwen Image 2.1 画像編集
</h3>

指示に従って画像を編集します。編集にソース画像にないコンテンツが必要な場合は、参照画像を追加してください。たとえば、2 枚目の写真の衣服を 1 枚目の人物に着せる場合などです。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_qwen_image_2_1_image_edit-1.webp" alt="Qwen-Image-2.1 画像編集ワークフローのプレビュー" />

<CardGroup cols={2}>
  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_qwen_image_2_1_image_edit.json">
    JSON をダウンロードするか、テンプレートライブラリで「Qwen-Image-2.1」を検索してください
  </Card>

  <Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=image_qwen_image_2_1_image_edit&utm_source=docs&utm_medium=referral&utm_campaign=qwen-image-2-1">
    セットアップ不要で ComfyUI をオンライン実行
  </Card>
</CardGroup>

**入力素材**

以下のファイルを対応する `LoadImage` ノードにアップロードしてください:

<CardGroup cols={2}>
  <Card title="portrait_model_denim.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/portrait_model_denim.png">
    `LoadImage` ノード 470 · `portrait_model_denim.png`
  </Card>

  <Card title="clothing_light_blue_denim_shirt.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/clothing_light_blue_denim_shirt.png">
    `LoadImage` ノード 475 · `clothing_light_blue_denim_shirt.png`
  </Card>
</CardGroup>

**出力例**

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/portrait_model_denim.png" alt="入力画像" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />

  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/output/image_qwen_image_2_1_image_edit.png" alt="Qwen-Image-2.1 画像編集の出力例" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

<h3 id="image_qwen_image_2_1_background_removal">
  背景の削除: Qwen Image 2.1
</h3>

編集指示で写真の背景を削除します。このワークフローは画像編集のサブグラフを再利用し、プロンプトは `Remove the background, and output a PNG image` です。結果は元画像と比較できます。

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_qwen_image_2_1_background_removal-1.webp" alt="Qwen-Image-2.1 背景削除ワークフローのプレビュー" />

<CardGroup cols={2}>
  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_qwen_image_2_1_background_removal.json">
    JSON をダウンロードするか、テンプレートライブラリで「Qwen-Image-2.1」を検索してください
  </Card>

  <Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=image_qwen_image_2_1_background_removal&utm_source=docs&utm_medium=referral&utm_campaign=qwen-image-2-1">
    セットアップ不要で ComfyUI をオンライン実行
  </Card>
</CardGroup>

**入力素材**

以下のファイルを対応する `LoadImage` ノードにアップロードしてください:

<Card title="angry_broccoli.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/angry_broccoli.png">
  `LoadImage` ノード 470 · `angry_broccoli.png`
</Card>

## モデルのダウンロード先

3 つのワークフローは diffusion モデル、VAE、ベースのテキストエンコーダーを共有します。Text to image と Image edit のテンプレートはそれぞれプロンプト強化用のテキストエンコーダーを追加で読み込みます。Text to image は `qwen3.5_9b_qwen_image_2.1_pe_t2i`、Image edit は `qwen3.5_9b_qwen_image_2.1_pe_i2i` です。

**text\_encoders**

* [qwen3vl\_8b\_int8\_convrot.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/text_encoders/qwen3vl_8b_int8_convrot.safetensors)（テンプレートが読み込むデフォルト、メモリ使用量は少なめ）
* [qwen3vl\_8b\_bf16.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/text_encoders/qwen3vl_8b_bf16.safetensors)（フル精度、より多くのメモリが必要）
* [qwen3.5\_9b\_qwen\_image\_2.1\_pe\_t2i.int8\_convrot.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/text_encoders/qwen3.5_9b_qwen_image_2.1_pe_t2i.int8_convrot.safetensors)（Text to image テンプレートのプロンプト強化）
* [qwen3.5\_9b\_qwen\_image\_2.1\_pe\_i2i.int8\_convrot.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/text_encoders/qwen3.5_9b_qwen_image_2.1_pe_i2i.int8_convrot.safetensors)（Image edit テンプレートのプロンプト強化）

**diffusion\_models**

* [qwen\_image\_2.1\_int8\_convrot.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/diffusion_models/qwen_image_2.1_int8_convrot.safetensors)（テンプレートが読み込むデフォルト、メモリ使用量は少なめ）
* [qwen\_image\_2.1\_bf16.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/diffusion_models/qwen_image_2.1_bf16.safetensors)（フル精度、より多くのメモリが必要）

**vae**

* [qwen\_image\_2.1\_vae\_bf16.safetensors](https://huggingface.co/Comfy-Org/Qwen-Image-2.1/blob/main/vae/qwen_image_2.1_vae_bf16.safetensors)

**モデルの保存場所**

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 text_encoders/
│   │      ├── qwen3vl_8b_int8_convrot.safetensors
│   │      ├── qwen3vl_8b_bf16.safetensors
│   │      ├── qwen3.5_9b_qwen_image_2.1_pe_t2i.int8_convrot.safetensors
│   │      └── qwen3.5_9b_qwen_image_2.1_pe_i2i.int8_convrot.safetensors
│   ├── 📂 diffusion_models/
│   │      ├── qwen_image_2.1_int8_convrot.safetensors
│   │      └── qwen_image_2.1_bf16.safetensors
│   └── 📂 vae/
│          └── qwen_image_2.1_vae_bf16.safetensors
```

## ワークフロー設定

### サンプラー設定

3 つのワークフローはいずれも `steps` 25、`cfg` 1、`euler` サンプラー、`simple` スケジューラーでサンプリングします。

`cfg` が 1 のとき ComfyUI はネガティブ条件の計算をスキップするため、これらのワークフローではネガティブプロンプトが効果を持ちません。テンプレートは Qwen-Image-2.1 が公開されている経路である `cfg` 1 を維持しており、ネガティブプロンプトを効かせたい場合にのみ上げてください。`cfg` 2 では、小さな文字や数字を含む密なプロンプトへの追従性が上がりますが、その代わりエッジが過剰に強調されます。それより上げると露出が明るすぎたり暗すぎたりする方向に振れ、`cfg` 5 では品質が大きく低下し、`cfg` 0.5 では画像が壊れます。値は一度に 1 つだけ変え、固定シードで比較してください。

`steps` は 2 つ目の調整項目です。Qwen-Image-2.1 の公開パイプラインは `euler` サンプラーで約 40 から 50 ステップを使用しており、テンプレートはより低い 25 から始まります。単純な局所編集は 4 から 8 ステップでも成立するため、服の色を変えるといった指示はデフォルトより数倍速く生成できます。一方、画面全体を書き換える編集は一貫性を失い、25 ステップが必要です。手や指のような収束しにくい細部は 30 ステップ程度で落ち着き、25 から 40 ステップに上げると細部のざらつきが減ります。`steps` は、特定の箇所がどうしても収束しないときだけ調整してください。

### 解像度

**Text to image**：**Resolution Selector** ノードがアスペクト比とメガピクセルの目標値を設定します。1.0 MP はおよそ 1024x1024 です。Qwen-Image-2.1 は 2K をネイティブに生成するため、2048x2048 の正方形出力を得るには目標値を約 4.0 MP に設定してください。

**Image edit**：キャンバスは Image Edit サブグラフノードの `resolution` コントロールで決まります（範囲 `0` から `4096`、ステップ `32`）。ノード自体のデフォルトは `1024` で、テンプレートは `0` で配布されています。テンプレートのデフォルトである `custom_size` オフの場合、編集は最初の参照画像 `image_1` のサイズで生成されます：

* `resolution` が `0` の場合、各参照画像は自身のピクセルサイズのまま（32 の倍数に丸めて）保持されるため、3000x4000 の写真は 3008x4000 のキャンバスになります
* `resolution` が `0` より大きい場合、`image_1` のアスペクト比を `resolution` x `resolution` ピクセルの予算に合わせてスケーリングします。これは幅や高さではなく総ピクセル数であり、32 の倍数に丸められるため、同じ写真で `resolution` `1024` は約 896x1184 になります

`custom_size` をオンにすると、代わりに **Resolution Selector** からキャンバスを取得します。このときはリサイズ後の `image_1` のサイズに近い値にしてください。そうしないと編集がずれる可能性があります。

コストを決めるのはキャンバスサイズです。3000x4000 の参照画像は `resolution` が 0 のとき 3008x4000（約 12 MP）でサンプリングされ、同じ編集を `resolution` 1024 にすると約 896x1184（約 1 MP）になります。RTX 5090 ではおよそ 6 s/it と約 0.3 s/it の差になります。`resolution` を下げると生成結果が小さくなることで速くなり、細部が増えるわけではありません。編集が遅いと感じたら、他の設定を触る前に `resolution` と参照画像のピクセルサイズを確認してください。大きな参照画像を複数使うとさらに遅くなり、そのコストには下記の KV キャッシュ設定が影響します。また、モデルの学習済み 2K を大きく超える目標値（4K など）はプロンプト追従性が落ちます。

### 画像編集のためのプロンプト

参照画像はスロット順にテキストエンコーダーへ連結され、プロンプトは各画像をインデックスで指定します：

```
Keep the character and pose in <image1> unchanged, put this light blue denim shirt from <image2> on the character, preserve the original facial features, hair, body shape and pose
```

編集を特定の領域に限定するには、まず画像上にその領域をマークします。`image_1` を供給する `LoadImage` ノード（ノード 470：ノードを右クリックし、**マスクエディタで開く** を選択）で **Paint Pen** を使い、領域を塗って保存します。Paint Pen はマスクではなく画像の RGB レイヤーに描画するため、保存するとマーク付きの画像がノードに書き戻され、マークはこの編集が読み込む参照画像の一部になります。プロンプトでマークの色を指定すると、その指示をその領域に向けられます（例:「赤い領域のジャケットを変更する」）。マークは変更したい領域内にとどめてください。マークの色が結果に現れる場合は、希望する色もプロンプトに書いてください。

### KV キャッシュ

編集ワークフローには **Qwen Image 2.1 Cache** ノードが含まれており、サンプリングのステップ間でキャッシュされたテキストと参照プレフィックスを保持します。テンプレートのデフォルト設定はほとんどの環境でそのまま使えます。

このノードは実験的な機能で、2 つのコントロールがあります：

| コントロール | 値 | 効果 |
| - | - | - |
| `device` | `auto`（デフォルト）、`gpu`、`cpu`、`off` | `auto` は空き VRAM を使い、次に RAM を使います。`cpu`（RAM）は計算の裏でプリフェッチされるため速度の低下はわずかです。`off` は毎ステップでプレフィックスを再計算するため遅くなりますが、キャッシュを切り分けたいときに使えます |
| `dtype` | `default`（デフォルト）、`int8`、`int4` | 保存精度。`default` はロスレスです。`int8` はキャッシュを半分にしつつ bf16 程度の精度を保ち、`int4` は 4 分の 1 にしますが 1 ステップあたりの誤差はおよそ 2 倍になります |

### プロンプト強化

Text to image と Image edit のテンプレートには、任意のプロンプト強化ステップが含まれます。専用のテキストエンコーダーがサンプリング前にプロンプトを書き換え、短いリクエストをより詳細な記述に展開します。

どちらのテンプレートも、Qwen Image 2.1 サブグラフノードに次のコントロールを公開しています：

* `refine_prompt`：両方のテンプレートでデフォルトはオフです。オンにすると、画像モデルは入力したプロンプトではなく書き換え後のプロンプトでサンプリングします
* `PE_model`：書き換えを行うテキストエンコーダーです。Text to image は `qwen3.5_9b_qwen_image_2.1_pe_t2i.int8_convrot.safetensors`、Image edit は `qwen3.5_9b_qwen_image_2.1_pe_i2i.int8_convrot.safetensors` を使用します
* `thinking_mode`：両方のテンプレートでデフォルトはオフです。`refine_prompt` と一緒にオンにすると、書き換えモデルが出力前に推論できるようになります

サブグラフ内の **Preview Any** ノードには、実際に画像モデルへ渡されるプロンプトが表示されるので、書き換え結果を残すかどうかを判断する前に確認できます。書き換えモデルが従う指示は **Text (System Prompt)** ノードにあり、編集できます。強化ブランチは `refine_prompt` がオンのときだけ評価されるため、強化用テキストエンコーダーは両方のテンプレートで任意です。使用するには `refine_prompt` をオンにしてください。背景除去テンプレートにはこのステップはありません。


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