diff --git a/docs.json b/docs.json index 9f536ffd95..c0bacf138d 100644 --- a/docs.json +++ b/docs.json @@ -135,6 +135,7 @@ "interface/features/subgraph", "interface/features/partial-execution", "interface/features/node-docs", + "interface/features/autogrow-inputs", { "group": "ComfyUI Settings", "icon": "gear", @@ -3988,6 +3989,7 @@ "zh/interface/features/subgraph", "zh/interface/features/partial-execution", "zh/interface/features/node-docs", + "zh/interface/features/autogrow-inputs", { "group": "ComfyUI 设置", "icon": "gear", @@ -7860,6 +7862,7 @@ "ja/interface/features/subgraph", "ja/interface/features/partial-execution", "ja/interface/features/node-docs", + "ja/interface/features/autogrow-inputs", { "group": "ComfyUI Settings", "icon": "gear", @@ -11745,6 +11748,7 @@ "ko/interface/features/subgraph", "ko/interface/features/partial-execution", "ko/interface/features/node-docs", + "ko/interface/features/autogrow-inputs", { "group": "ComfyUI 설정", "icon": "gear", diff --git a/images/interface/features/autogrow/autogrow-1.png b/images/interface/features/autogrow/autogrow-1.png new file mode 100644 index 0000000000..ecacf26795 Binary files /dev/null and b/images/interface/features/autogrow/autogrow-1.png differ diff --git a/images/interface/features/autogrow/autogrow-2.png b/images/interface/features/autogrow/autogrow-2.png new file mode 100644 index 0000000000..afcfea34b5 Binary files /dev/null and b/images/interface/features/autogrow/autogrow-2.png differ diff --git a/interface/features/autogrow-inputs.mdx b/interface/features/autogrow-inputs.mdx new file mode 100644 index 0000000000..08fc85f08a --- /dev/null +++ b/interface/features/autogrow-inputs.mdx @@ -0,0 +1,43 @@ +--- +title: "Autogrow Inputs - Dynamic Node Inputs in ComfyUI" +description: "Autogrow inputs add a new slot to a node when you fill the last one, so a single node can take as many images, masks or latents as you need." +sidebarTitle: "Autogrow Inputs" +icon: "plus" +--- + +![Batch Images node with one image connected and one free input below it](/images/interface/features/autogrow/autogrow-1.png) + +Some nodes in ComfyUI have **autogrow inputs**, also called **dynamic inputs**. These nodes do not show a fixed list of slots. They add another input as soon as you connect the last free one, so a single node can batch two images or twenty without any extra setup. + +## How autogrow inputs work + +1. **Connect the last free input.** In the example on this page, an image source is linked to `image0` on the **Batch Images** node, while `image1` is still free. +2. **Watch the node grow.** As soon as you fill the last free input, the node appends a new empty input below it. In the picture below, the new `image2` input appears after `image1` is connected. +3. **Repeat as needed.** Every time you fill the last input, the node grows again, until it reaches the maximum number of inputs that node allows. + +![Batch Images node with two connected inputs and a newly added free input highlighted](/images/interface/features/autogrow/autogrow-2.png) + +Two more details worth knowing: + +- **Order matters.** The inputs are passed to the node in the order they appear, so `image0` comes before `image1` and so on. Keep that in mind when the result depends on the sequence, for example when you batch images that run through a video model. +- **The free input is a placeholder.** It is only part of the node's data once you connect something to it. A node that allows zero inputs still runs when every slot is empty. + +## Nodes that use autogrow inputs + +| Node | Input that grows | Maximum inputs | +|---|---|---| +| **Batch Images** | `image` | 50 | +| **Batch Masks** | `mask` | 50 | +| **Batch Latents** | `latent` | 50 | +| **And** / **Or** | `value` | 10 | +| **Nano Banana 2** and other partner nodes that take reference images | `image_1`, `image_2`, and so on | up to 14 images | + +Each node decides its own limits. Hover the input in ComfyUI to read its tooltip when you are not sure how many values it accepts. + + +Autogrow is part of the ComfyUI V3 node schema. If you write custom nodes, see [Dynamic Inputs](/custom-nodes/v3_migration#dynamic-inputs) for the `Autogrow` template API. + + + + Combine several images into one batch, with as many inputs as you need. + diff --git a/ja/interface/features/autogrow-inputs.mdx b/ja/interface/features/autogrow-inputs.mdx new file mode 100644 index 0000000000..ec4e75ae53 --- /dev/null +++ b/ja/interface/features/autogrow-inputs.mdx @@ -0,0 +1,45 @@ +--- +title: "自動拡張入力 - ComfyUI の動的ノード入力" +description: "自動拡張入力（動的入力）は、最後の入力を接続すると新しいスロットを自動で追加します。1 つのノードで必要なだけ画像やマスク、Latent をまとめられます。" +sidebarTitle: "自動拡張入力" +icon: "plus" +translationSourceHash: 2b0c8011 +translationFrom: interface/features/autogrow-inputs.mdx +--- + +![画像を 1 つ接続し、下に空き入力が 1 つある Batch Images ノード](/images/interface/features/autogrow/autogrow-1.png) + +ComfyUI には**自動拡張入力**（autogrow inputs、動的入力とも呼ばれます）を持つノードがあります。こうしたノードは入力スロットを固定で表示しません。最後の空き入力を接続すると、次の入力が自動的に追加されます。そのため 1 つのノードで、2 枚でも 20 枚でも画像をまとめて扱えます。 + +## 自動拡張入力の仕組み + +1. **最後の空き入力を接続する。** このページの例では、**Batch Images** ノードの `image0` に画像を接続し、`image1` は空きのままです。 +2. **ノードが自動で伸びる。** 最後の空き入力を埋めると、その下に新しい空の入力が追加されます。下の図では `image1` を接続したあとに `image2` が現れています。 +3. **必要なだけ繰り返す。** 最後の入力を埋めるたびにノードは再び伸び、そのノードが許可する最大入力数まで増えていきます。 + +![2 つの入力を接続し、新しく追加された空き入力がハイライトされた Batch Images ノード](/images/interface/features/autogrow/autogrow-2.png) + +知っておくと役立つ点が 2 つあります。 + +- **順序に意味があります。** 入力は表示されている順にノードへ渡されるため、`image0` が `image1` より先になります。順番が結果に影響する場合（例: 動画モデルにまとめて渡す画像）は注意してください。 +- **空き入力はプレースホルダーです。** 何か接続して初めてノードのデータの一部になります。0 個の入力も許可するノードは、すべてのスロットが空でも実行できます。 + +## 自動拡張入力を使うノード + +| ノード | 伸びる入力 | 最大入力数 | +|---|---|---| +| **Batch Images** | `image` | 50 | +| **Batch Masks** | `mask` | 50 | +| **Batch Latents** | `latent` | 50 | +| **And** / **Or** | `value` | 10 | +| **Nano Banana 2** など参照画像を取るパートナーノード | `image_1`、`image_2` など | 最大 14 枚 | + +上限はノードごとに決まっています。いくつ受け取れるか分からないときは、ComfyUI 上で入力にマウスを重ねてツールチップを確認してください。 + + +自動拡張は ComfyUI の V3 ノードスキーマの一部です。カスタムノードを書く場合は、[動的入力](/ja/custom-nodes/v3_migration#動的入力)の `Autogrow` テンプレート API を参照してください。 + + + + 複数の画像を 1 つのバッチにまとめます。入力は必要なだけ追加できます。 + diff --git a/ko/interface/features/autogrow-inputs.mdx b/ko/interface/features/autogrow-inputs.mdx new file mode 100644 index 0000000000..0b418a012d --- /dev/null +++ b/ko/interface/features/autogrow-inputs.mdx @@ -0,0 +1,45 @@ +--- +title: "자동 확장 입력 - ComfyUI의 동적 노드 입력" +description: "자동 확장 입력(동적 입력)은 마지막 입력을 연결하면 슬롯을 자동으로 추가합니다. 노드 하나로 필요한 만큼 이미지, 마스크, Latent를 모을 수 있습니다." +sidebarTitle: "자동 확장 입력" +icon: "plus" +translationSourceHash: 2b0c8011 +translationFrom: interface/features/autogrow-inputs.mdx +--- + +![이미지 하나를 연결하고 아래에 빈 입력이 하나 있는 Batch Images 노드](/images/interface/features/autogrow/autogrow-1.png) + +ComfyUI에는 **자동 확장 입력**(autogrow inputs, 동적 입력)을 가진 노드가 있습니다. 이런 노드는 입력 슬롯을 고정으로 보여주지 않습니다. 마지막 빈 입력을 연결하면 다음 입력이 자동으로 추가됩니다. 그래서 노드 하나로 이미지 두 장이든 스무 장이든 묶어서 처리할 수 있습니다. + +## 자동 확장 입력의 동작 방식 + +1. **마지막 빈 입력을 연결합니다.** 이 페이지의 예시에서는 **Batch Images** 노드의 `image0`에 이미지를 연결했고, `image1`은 비어 있습니다. +2. **노드가 늘어납니다.** 마지막 빈 입력을 채우면 그 아래에 새 빈 입력이 추가됩니다. 아래 그림에서는 `image1`을 연결한 뒤 `image2`가 나타났습니다. +3. **필요한 만큼 반복합니다.** 마지막 입력을 채울 때마다 노드가 다시 늘어나며, 해당 노드가 허용하는 최대 입력 수까지 증가합니다. + +![입력 두 개를 연결하고 새로 추가된 빈 입력이 강조된 Batch Images 노드](/images/interface/features/autogrow/autogrow-2.png) + +알아두면 좋은 두 가지가 있습니다. + +- **순서가 중요합니다.** 입력은 화면에 보이는 순서대로 노드에 전달되므로 `image0`이 `image1`보다 먼저 옵니다. 순서가 결과에 영향을 주는 경우(예: 이미지를 한꺼번에 동영상 모델로 보낼 때)에는 특히 주의하세요. +- **빈 입력은 자리 표시자입니다.** 무언가 연결해야 노드 데이터의 일부가 됩니다. 입력 0개를 허용하는 노드는 모든 슬롯이 비어 있어도 실행됩니다. + +## 자동 확장 입력을 사용하는 노드 + +| 노드 | 늘어나는 입력 | 최대 입력 수 | +|---|---|---| +| **Batch Images** | `image` | 50 | +| **Batch Masks** | `mask` | 50 | +| **Batch Latents** | `latent` | 50 | +| **And** / **Or** | `value` | 10 | +| **Nano Banana 2** 등 참조 이미지를 받는 파트너 노드 | `image_1`, `image_2` 등 | 최대 14장 | + +상한은 노드마다 다릅니다. 몇 개까지 받는지 확실하지 않다면 ComfyUI에서 입력 위에 마우스를 올려 툴팁을 확인하세요. + + +자동 확장은 ComfyUI V3 노드 스키마의 일부입니다. 커스텀 노드를 만든다면 [동적 입력](/ko/custom-nodes/v3_migration#동적-입력)의 `Autogrow` 템플릿 API를 참고하세요. + + + + 여러 이미지를 하나의 배치로 묶습니다. 입력은 필요한 만큼 추가할 수 있습니다. + diff --git a/zh/interface/features/autogrow-inputs.mdx b/zh/interface/features/autogrow-inputs.mdx new file mode 100644 index 0000000000..1bc5527eb3 --- /dev/null +++ b/zh/interface/features/autogrow-inputs.mdx @@ -0,0 +1,45 @@ +--- +title: "自动增长输入 - ComfyUI 的动态节点输入" +description: "自动增长输入（动态输入）会在你连上最后一个输入后自动新增一个插槽，让一个节点就能接收任意数量的图像、蒙版或潜空间。" +sidebarTitle: "自动增长输入" +icon: "plus" +translationSourceHash: 2b0c8011 +translationFrom: interface/features/autogrow-inputs.mdx +--- + +![Batch Images 节点已连接一张图像，下方还有一个空闲输入](/images/interface/features/autogrow/autogrow-1.png) + +ComfyUI 中有些节点带有**自动增长输入**（autogrow inputs），也叫**动态输入**。这类节点不会固定显示一组输入插槽：当你把最后一个空闲输入连上之后，它会自动再增加一个输入，所以一个节点就能批处理两张或二十张图像，不需要额外设置。 + +## 自动增长输入的工作方式 + +1. **连上最后一个空闲输入。** 以本页的 **Batch Images** 节点为例，把图像连到 `image0`，此时 `image1` 仍为空闲状态。 +2. **节点随之增长。** 一旦最后一个空闲输入被连上，节点就会在下方自动新增一个空输入。下图里 `image1` 连上后，新的 `image2` 输入出现了。 +3. **按需重复。** 每当最后一个输入被占满，节点就会继续增长，直到达到该节点允许的最大输入数。 + +![Batch Images 节点已连接两个输入，并高亮显示新出现的空闲输入](/images/interface/features/autogrow/autogrow-2.png) + +还有两点需要注意： + +- **顺序有意义。** 输入会按显示顺序传给节点，`image0` 排在 `image1` 之前，依此类推。当结果与顺序有关时（例如这些图像要一起送进视频模型）要特别留意。 +- **空闲输入只是占位。** 只有真正连上内容后，它才属于节点数据的一部分；允许 0 个输入的节点即使所有插槽都空着也能运行。 + +## 使用自动增长输入的节点 + +| 节点 | 会增长的输入 | 最大输入数 | +|---|---|---| +| **Batch Images** | `image` | 50 | +| **Batch Masks** | `mask` | 50 | +| **Batch Latents** | `latent` | 50 | +| **And** / **Or** | `value` | 10 | +| **Nano Banana 2** 等需要参考图的合作节点 | `image_1`、`image_2` 等 | 最多 14 张图 | + +每个节点自己决定上限。不确定某个输入能接多少值时，在 ComfyUI 里把鼠标悬停在输入上查看提示。 + + +自动增长属于 ComfyUI V3 节点 schema。如果你在编写自定义节点，请参考[动态输入](/zh/custom-nodes/v3_migration#动态输入)中的 `Autogrow` 模板 API。 + + + + 把多张图像合并成一个批次，输入数量按需增加。 +