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

# HunyuanImageEditApi - ComfyUI Built-in Node Documentation

> Tencent HY Image: Edit ノードは、Tencent の Hunyuan Image モデルを使用して、テキスト指示に従って参照画像を編集または結合します。

Tencent HY Image: Edit ノードは、Tencent の Hunyuan Image モデルを使用して、テキスト指示に従って参照画像を編集または結合します。1～5 枚の画像を接続し、プロンプトで変更内容を説明し、画像を `@Image1`、`@Image2` などで参照します。このノードは参照画像をアップロードし、API にリクエストを送信して、編集結果を返します。

## 入力

### 共通入力

| パラメータ | 説明                                      | データ型           | 必須 | 範囲                       |
| ----- | --------------------------------------- | -------------- | -- | ------------------------ |
| `モデル` | 編集に使用するモデル。選択したモデルによって、表示される追加入力が決まります。 | DYNAMIC\_COMBO | はい | `"hy-image-3.5-preview"` |

### hy-image-3.5-preview 入力

| パラメータ              | 説明                                                                                                                                                                   | データ型    | 必須  | 範囲                                                                                                                                                 |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | --- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`           | 編集指示。接続された画像への `@Image1` 形式の参照をサポートします。空にできません（デフォルト: 空）。                                                                                                            | STRING  | はい  | 任意のテキスト                                                                                                                                            |
| `aspect_ratio`     | 出力のアスペクト比。`"auto"` は最初の参照画像のアスペクト比に従い、4K では使用できません。`resolution` が `"custom"` の場合は無視されます。                                                                             | COMBO   | はい  | `"auto"`<br />`"1:1"`<br />`"3:2"`<br />`"2:3"`<br />`"4:3"`<br />`"3:4"`<br />`"16:9"`<br />`"9:16"`<br />`"21:9"`<br />`"9:21"`（デフォルト: `"auto"`） |
| `resolution`       | 出力のピクセル面積: 1K は約 1024x1024、2K は約 2048x2048、4K は約 4096x4096 です。2K を超えるものは 2K でレンダリングされ、モデルによってアップスケールされます。プリセットの面積の代わりに `width` と `height` を使用するには、`"custom"` に設定します。 | COMBO   | はい  | `"1K"`<br />`"2K"`<br />`"4K"`<br />`"custom"`（デフォルト: `"2K"`）                                                                                      |
| `width`            | 出力の幅（ピクセル単位）。`resolution` が `"custom"` の場合にのみ使用されます。                                                                                                                 | INT     | はい  | 256-8192、16 刻み（デフォルト: 2048）                                                                                                                        |
| `height`           | 出力の高さ（ピクセル単位）。`resolution` が `"custom"` の場合にのみ使用されます。                                                                                                                | INT     | はい  | 256-8192、16 刻み（デフォルト: 2048）                                                                                                                        |
| `seed`             | 生成に使用するシード。同じシードでも実行ごとに結果が変動します。                                                                                                                                     | INT     | はい  | 0-2147483647（デフォルト: 42）                                                                                                                            |
| `reference_detail` | モデルが参照画像の詳細をどの程度認識するか: `"standard"` では画像ごとに最大 1024x1024 ピクセル、`"high"` では最大 2048x2048 ピクセルまで認識でき、小さなテキストや細かいディテールをよりよく保持しますが、時間がかかります。これは高度なパラメータです。                  | COMBO   | いいえ | `"standard"`<br />`"high"`（デフォルト: `"standard"`）                                                                                                    |
| `watermark`        | 結果に AI 生成のウォーターマークを追加するかどうか。これは高度なパラメータです。                                                                                                                           | BOOLEAN | いいえ | true<br />false（デフォルト: false）                                                                                                                      |

### 参照入力

| パラメータ    | 説明                                                                                                                                                | データ型  | 必須 | 範囲       |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | -- | -------- |
| `images` | 編集または結合する参照画像。拡張可能なスロット: 1～5 枚の画像（`image_1` から `image_5`）を接続します。プロンプト内では `@Image1` ... `@Image5` として参照し、入力順に番号が付けられます。バッチ入力は画像ごとに 1 回としてカウントされます。 | IMAGE | はい | 1～5 枚の画像 |

`prompt` は空にできません。また、`@Image3` のようなプロンプト参照は、接続されている画像が 1 枚または 2 枚だけの場合にエラーを発生させます。合計で最大 5 枚の参照画像を使用でき、バッチの各画像は個別にカウントされます。`"custom"` 解像度では、`width` と `height` はどちらも 16 の倍数である必要があり、その積は 4096 x 4096 ピクセルの面積制限（約 16.7 メガピクセル）を超えてはいけません。アスペクト比は任意ですが、およそ 6:1 を超えるとモデルが被写体を繰り返し始めます。`"auto"` アスペクト比は 2K の面積制限内でのみ機能するため、4K では明示的なアスペクト比を選択するか、`"custom"` を使用してください。

## 出力

| 出力名     | 説明                       | データ型  |
| ------- | ------------------------ | ----- |
| `IMAGE` | 参照画像とプロンプトから生成された編集済み画像。 | IMAGE |

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

***

**Source fingerprint (SHA-256):** `46c112347b51a2983521f87bbeb047289515f4073c48ba5d909fd3bae4597633`
