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

# QwenImageEditApi - ComfyUI Built-in Node Documentation

> このノードは Qwen-Image 3.0 モデルを使用し、テキストプロンプトに従って最大3枚の参照画像を編集または合成します。

このノードは Qwen-Image 3.0 モデルを使用し、テキストプロンプトに従って最大3枚の参照画像を編集または合成します。モデルを選択し、プロンプトと参照画像を指定すると、ノードは1枚以上の生成画像を返します。

## 入力

### 共通入力

| パラメータ           | 説明                                                                                            | データ型           | 必須  | 範囲                                         |
| --------------- | --------------------------------------------------------------------------------------------- | -------------- | --- | ------------------------------------------ |
| `model`         | 使用するモデル。この選択には、テキストプロンプト、最大3つの参照画像入力、およびオプションのネガティブプロンプトも含まれます。                               | DYNAMIC\_COMBO | はい  | "qwen-image-3.0-pro"<br />"qwen-image-3.0" |
| `size`          | 出力解像度。"match input" は最初の参照画像のサイズを再利用し、"auto" は同じアスペクト比でモデルにサイズを選択させ、"custom" は明示的な幅と高さを設定します。 | DYNAMIC\_COMBO | はい  | "match input"<br />"auto"<br />"custom"    |
| `n`             | 生成する画像の枚数。バッチとして返されます。（デフォルト: 1）                                                              | INT            | いいえ | 1～6                                        |
| `seed`          | 生成に使用するシード。（デフォルト: 42）                                                                        | INT            | いいえ | 0～2147483647                               |
| `prompt_extend` | AI支援でプロンプトを拡張するかどうか。（デフォルト: True）                                                             | BOOLEAN        | いいえ | True<br />False                            |
| `watermark`     | 結果にAI生成の透かしを追加するかどうか。（デフォルト: False）                                                           | BOOLEAN        | いいえ | True<br />False                            |

### qwen-image-3.0-pro と qwen-image-3.0 入力

両モデルは同じサブパラメータを共有します。

| パラメータ             | 説明                                                      | データ型   | 必須  | 範囲 |
| ----------------- | ------------------------------------------------------- | ------ | --- | -- |
| `prompt`          | 編集指示。英語と中国語、および入力画像への @Image1 形式の参照をサポートします。（デフォルト: ""） | STRING | はい  | -  |
| `negative_prompt` | 回避したい内容を記述するネガティブプロンプト。（デフォルト: ""）                      | STRING | いいえ | -  |

### 参照入力

| パラメータ    | 説明                                                                                                                                      | データ型  | 必須 | 範囲  |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------- | ----- | -- | --- |
| `images` | 拡張可能なスロット: 1～3枚の参照画像（`image_1`、`image_2`、`image_3`）を接続します。プロンプト内では @Image1、@Image2、@Image3 として参照します。入力順に番号が付けられ、バッチ入力は画像1枚につき1回として数えます。 | IMAGE | はい | 1～3 |

### カスタムサイズ入力

`size` が "custom" に設定されているときに表示されます。

| パラメータ    | 説明                                                                                      | データ型 | 必須                        | 範囲              |
| -------- | --------------------------------------------------------------------------------------- | ---- | ------------------------- | --------------- |
| `width`  | 出力幅。合計ピクセル面積は 512x512 ～ 2560x2560 の範囲内である必要があり、その範囲内であれば任意のアスペクト比を使用できます。（デフォルト: 1024）  | INT  | はい（`size` が "custom" の場合） | 256～2560、ステップ16 |
| `height` | 出力高さ。合計ピクセル面積は 512x512 ～ 2560x2560 の範囲内である必要があり、その範囲内であれば任意のアスペクト比を使用できます。（デフォルト: 1024） | INT  | はい（`size` が "custom" の場合） | 256～2560、ステップ16 |

### 制約

* テキストプロンプトは必須であり、少なくとも1文字を含む必要があります。
* 参照画像は最大3枚までサポートされます。それ以上指定するとエラーが発生します（バッチ入力は画像1枚につき1回として数えます）。
* `size` が "custom" に設定されている場合、明示的な幅と高さを指定する必要があり、検証されます。合計ピクセル面積は 262,144（512x512）～ 6,553,600（2560x2560）ピクセルの範囲内で、アスペクト比は 1:8 ～ 8:1 の範囲内である必要があります。
* `size` が "match input" に設定されている場合、最初の参照画像の寸法が使用されるため、少なくとも1枚の参照画像が必要です。寸法は、サポートされる面積とアスペクト比の範囲に収まるようにスケーリングされます。
* `size` が "auto" に設定されている場合、モデルは入力のアスペクト比を維持しながら出力サイズ（1.9～4.2メガピクセル）を選択します。
* プロンプト参照では @Image1、@Image2、@Image3 を使用し、入力順に番号が付けられます。接続されている画像数より大きいインデックスを参照するとエラーが発生します。タグは単語境界でのみ認識されるため、[user@image1.com](mailto:user@image1.com) のようなアドレスは変更されません。
* 入力参照画像は API に送信される前に最大 2048x2048 ピクセルにダウンスケールされます。PNG エンコーディングが API のサイズ制限を超える場合は、代わりに JPEG エンコーディングが使用されます。

## 出力

| 出力名     | 説明                                     | データ型  |
| ------- | -------------------------------------- | ----- |
| `IMAGE` | 生成された画像。バッチとして返されます。最大 `n` 枚の画像が返されます。 | IMAGE |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/QwenImageEditApi/ja.md)

***

**Source fingerprint (SHA-256):** `efa8d2b1a039a7b91789c0332b751a5f90ab8dad755ef0e25124d7d1c44d9abb`
