# Ideogram 4.5 精密編集

テキストプロンプトに導かれて、Ideogram 4.5 の精密編集で画像を編集します。プロンプトで要求された部分だけが変更され、未変更のピクセルは同一に保たれ、出力は画像1のサイズを維持します。画像1は編集対象の画像で、最大4枚の追加画像を参照として接続できます。画像1の単一領域だけを、マスクまたはバウンディングボックスで選択して個別に編集することもでき、その場合は画像がフルサイズで返されます。

## 入力

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
|-----------|-------------|-----------|----------|-------|
| `モデル` | 使用するモデルです。（デフォルト: `"ideogram-4.5"`） | DYNAMIC_COMBO | はい | `"ideogram-4.5"` |
| `images` | 拡張可能なスロット: 画像1は編集対象の画像で、画像2～5は任意の参照です（`image_1` ... `image_5`）。プロンプト内では @Image1、@Image2、... として参照します。バッチ入力は画像ごとに1回として数えます。各画像のアスペクト比は1:6～6:1である必要があります。ただし、コンテキストウィンドウの使用中は画像1のアスペクト比チェックは行われません。 | IMAGE | はい | 1〜5枚の画像 |
| `prompt` | 編集指示です。接続された画像への @Image1 形式の参照をサポートします。（デフォルト: 空文字列） | STRING | はい | 1〜10000文字 |
| `quality` | 品質ティアです。上位のティアほどコストが高く、時間もかかります。（デフォルト: `"medium"`） | COMBO | はい | `"very_low"`<br>`"low"`<br>`"medium"`<br>`"high"` |
| `seed` | 生成用のシードです。同じ画像、プロンプト、設定、シードであれば同じ結果になります。（デフォルト: 42） | INT | はい | 0〜2147483647 |
| `context_window` | 画像1の編集対象領域です。`"none"` は画像全体を編集します。`"auto"` は `context_window_mask` の周囲の領域を編集し、`"custom"` は `context_window_bboxes` からの領域を編集します。どちらも画像1をフルサイズに保ち、画像の残りの部分は変更しません。（デフォルト: `"none"`） | COMBO | いいえ | `"none"`<br>`"auto"`<br>`"custom"` |
| `context_window_bboxes` | 画像1の編集対象領域です。たとえば、Create Bounding Boxes の出力です。`context_window` が `"custom"` の場合は必須で、それ以外では使用されません。複数のボックスは1つの領域に統合され、その領域は各辺少なくとも256ピクセル、アスペクト比が6:1以下になるように拡張されます。領域は各辺最大4608ピクセル、約4 MP（例: 2048x2048）まで可能です。 | BOUNDING_BOX | いいえ | - |
| `context_window_mask` | 白い部分が編集対象を示し、編集領域はその周囲に配置されます。`context_window` が `"auto"` の場合に必須で、それ以外では使用されません。マスクには白（編集）と黒（保持）の両方の領域が含まれている必要があります。 | MASK | いいえ | - |

### パラメータ制約

- **画像枚数:** 画像は最低1枚、最大5枚です。バッチ入力は画像ごとに1回として数えます。画像1は編集対象の画像で、画像2～5は参照です。`context_window_mask` を使用する場合、受け付けられる画像は最大4枚、つまり画像1と3枚の参照です。
- **出力サイズ:** 結果は画像1のサイズを維持するため、このノードにはサイズ、幅、高さの入力はありません。領域を編集する場合も同様で、変更された領域だけが異なる完全な画像が返されます。
- **画像のアスペクト比:** 各画像は、幅が高さの6倍を超えず、高さが幅の6倍を超えない（1:6～6:1）必要があります。`context_window` が `"auto"` または `"custom"` の間、画像1は対象外です。選択された領域だけが送信されるためです。
- **領域ソースのサイズ:** コンテキストウィンドウを使用する場合、画像1は最大8192x8192ピクセル（約67 MP）まで可能です。それより大きいソースはエラーになります。コンテキストウィンドウを使用しない場合、約4 MPを超える画像、または長辺が4608 pxを超える画像は、送信前に縮小されます。
- **領域の制限:** `context_window_bboxes` からの領域は、各辺最大4608ピクセル、約4 MPまで可能です。画像1の完全に外側にあるボックスはエラーになります。
- **プロンプトタグ:** `@ImageN` は大文字小文字を区別せずに照合され、接続された画像数を超えてはいけません。プロンプトは空白以外を含み、最大10000文字である必要があります。
- **アップロード制限:** 画像1、マスク、参照を合わせて Ideogram の50 MBアップロードに収まる必要があります。画像1は必要に応じてJPEGとして再エンコードされ、それでも収まらない場合はノードがエラーになります。
- **コンテンツ安全性:** Ideogram のコンテンツ安全性フィルターが結果をブロックした場合、ノードは画像を返さずにエラーになります。

## 出力

| 出力名 | 説明 | データ型 |
|-------------|-------------|-----------|
| `IMAGE` | 編集済み画像をバッチとして、画像1のサイズで返します。 | IMAGE |

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

---
**Source fingerprint (SHA-256):** `84f042739a8d7bc1a4b268f6175be6a598b67d32b9311fdf204a923472f5fcc9`
