Skip to content

docs: sync ModelMergeMOSSImage and ModelMergeSD2 node pages #2115

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
comfyui-wiki merged 1 commit into from
Oct 26, 2026
Merged

docs: sync ModelMergeMOSSImage and ModelMergeSD2 node pages #2115

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions built-in-nodes/ModelMergeMOSSImage.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: "ModelMergeMOSSImage - ComfyUI Built-in Node Documentation"
description: "The ModelMergeMOSSImage node merges two MOSS image models by blending their matching weights block by block"
sidebarTitle: "ModelMergeMOSSImage"
icon: "circle"
mode: wide
---

The ModelMergeMOSSImage node merges two MOSS image models by blending their matching weights block by block, so one part of the result can come from a base model and the rest from a fine-tune or a second model. Every major component of the architecture has its own ratio: the video embedder, the text embedder, the time embedding, the shared block modulation, all 42 transformer layers, and the output heads.

## Inputs

| Parameter | Description | Data Type | Required | Range |
| --- | --- | --- | --- | --- |
| `model1` | The first model to merge. Everything the second model does not contribute is kept from this model | MODEL | Yes | - |
| `model2` | The second model to merge. Its weights are blended in according to the ratios below | MODEL | Yes | - |
| `video_embedder.` | Blend ratio for the video embedder block (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `text_embedder.proj.` | Blend ratio for the projection layer of the text embedder (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `text_embedder.blocks.0.` and `text_embedder.blocks.1.` | Blend ratio for each of the two text embedder blocks (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `time_embedding.` | Blend ratio for the time embedding block (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `shared_block_modulation.` | Blend ratio for the shared modulation layer used by the transformer blocks (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `layers.0.` through `layers.41.` | Blend ratio for each of the 42 transformer layers (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `final_norm_video.` | Blend ratio for the final normalization of the video stream (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `final_linear_video.` | Blend ratio for the final linear layer of the video stream (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `video_head_modulation.` | Blend ratio for the modulation layer of the video output head (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |

A ratio of 0.0 keeps that component as it is in `model1`, a ratio of 1.0 takes it entirely from `model2`, and values in between produce a weighted blend. Both inputs must be MOSS image models with the same architecture; weights that do not match any of the prefixes above fall back to the ratio of `video_embedder.`.

## Outputs

| Output Name | Description | Data Type |
| --- | --- | --- |
| `MODEL` | The merged model, combining both inputs according to the specified ratios | MODEL |

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelMergeMOSSImage/en.md)
Comment thread
coderabbitai[bot] marked this conversation as resolved.

---
**Source fingerprint (SHA-256):** `3b7d9c806a8d53ad00044bf30f5e63431fea7ee565414acb70a56e3059164288`
35 changes: 35 additions & 0 deletions built-in-nodes/ModelMergeSD2.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
title: "ModelMergeSD2 - ComfyUI Built-in Node Documentation"
description: "The ModelMergeSD2 node merges two Stable Diffusion 2.x models by blending their matching components, with a separate weight for the time embedding"
sidebarTitle: "ModelMergeSD2"
icon: "circle"
mode: wide
---

The ModelMergeSD2 node merges two Stable Diffusion 2.x models by blending their matching components, with a separate weight for the time embedding, the label embedding, and every input, middle, and output block. The block layout is the same as in ModelMergeSD1, so both nodes expose the same set of ratios.

## Inputs

| Parameter | Description | Data Type | Required | Range |
| --- | --- | --- | --- | --- |
| `model1` | The first model to merge. Everything the second model does not contribute is kept from this model | MODEL | Yes | - |
| `model2` | The second model to merge. Its weights are blended in according to the ratios below | MODEL | Yes | - |
| `time_embed.` | Blend ratio for the time embedding layer (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `label_emb.` | Blend ratio for the label embedding layer (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `input_blocks.0.` through `input_blocks.11.` | Blend ratio for each of the 12 input blocks (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `middle_block.0.` through `middle_block.2.` | Blend ratio for each of the 3 middle blocks (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `output_blocks.0.` through `output_blocks.11.` | Blend ratio for each of the 12 output blocks (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |
| `out.` | Blend ratio for the output layer (default: 1.0) | FLOAT | Yes | 0.0 to 1.0 (step: 0.01) |

A ratio of 0.0 keeps that component as it is in `model1`, a ratio of 1.0 takes it entirely from `model2`, and values in between produce a weighted blend. Both inputs must be Stable Diffusion 2.x models with the same block structure.

## Outputs

| Output Name | Description | Data Type |
| --- | --- | --- |
| `MODEL` | The merged model, combining both inputs according to the specified ratios | MODEL |

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelMergeSD2/en.md)

---
**Source fingerprint (SHA-256):** `b9d53f126139412fbd8b21be72e1dcdb02736519ab4dc9e28c7840d69acb7c87`
10 changes: 10 additions & 0 deletions docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2776,8 +2776,10 @@
"built-in-nodes/ModelMergeKrea2",
"built-in-nodes/ModelMergeLTXV",
"built-in-nodes/ModelMergeMochiPreview",
"built-in-nodes/ModelMergeMOSSImage",
"built-in-nodes/ModelMergeQwenImage",
"built-in-nodes/ModelMergeSD1",
"built-in-nodes/ModelMergeSD2",
"built-in-nodes/ModelMergeSD35_Large",
"built-in-nodes/ModelMergeSD3_2B",
"built-in-nodes/ModelMergeSDXL",
Expand Down Expand Up @@ -5965,8 +5967,10 @@
"zh/built-in-nodes/ModelMergeKrea2",
"zh/built-in-nodes/ModelMergeLTXV",
"zh/built-in-nodes/ModelMergeMochiPreview",
"zh/built-in-nodes/ModelMergeMOSSImage",
"zh/built-in-nodes/ModelMergeQwenImage",
"zh/built-in-nodes/ModelMergeSD1",
"zh/built-in-nodes/ModelMergeSD2",
"zh/built-in-nodes/ModelMergeSD35_Large",
"zh/built-in-nodes/ModelMergeSD3_2B",
"zh/built-in-nodes/ModelMergeSDXL",
Expand Down Expand Up @@ -10026,8 +10030,10 @@
"ja/built-in-nodes/ModelMergeKrea2",
"ja/built-in-nodes/ModelMergeLTXV",
"ja/built-in-nodes/ModelMergeMochiPreview",
"ja/built-in-nodes/ModelMergeMOSSImage",
"ja/built-in-nodes/ModelMergeQwenImage",
"ja/built-in-nodes/ModelMergeSD1",
"ja/built-in-nodes/ModelMergeSD2",
"ja/built-in-nodes/ModelMergeSD35_Large",
"ja/built-in-nodes/ModelMergeSD3_2B",
"ja/built-in-nodes/ModelMergeSDXL",
Expand Down Expand Up @@ -14024,8 +14030,10 @@
"ko/built-in-nodes/ModelMergeKrea2",
"ko/built-in-nodes/ModelMergeLTXV",
"ko/built-in-nodes/ModelMergeMochiPreview",
"ko/built-in-nodes/ModelMergeMOSSImage",
"ko/built-in-nodes/ModelMergeQwenImage",
"ko/built-in-nodes/ModelMergeSD1",
"ko/built-in-nodes/ModelMergeSD2",
"ko/built-in-nodes/ModelMergeSD35_Large",
"ko/built-in-nodes/ModelMergeSD3_2B",
"ko/built-in-nodes/ModelMergeSDXL",
Expand Down Expand Up @@ -17564,8 +17572,10 @@
"es/built-in-nodes/ModelMergeKrea2",
"es/built-in-nodes/ModelMergeLTXV",
"es/built-in-nodes/ModelMergeMochiPreview",
"es/built-in-nodes/ModelMergeMOSSImage",
"es/built-in-nodes/ModelMergeQwenImage",
"es/built-in-nodes/ModelMergeSD1",
"es/built-in-nodes/ModelMergeSD2",
"es/built-in-nodes/ModelMergeSD35_Large",
"es/built-in-nodes/ModelMergeSD3_2B",
"es/built-in-nodes/ModelMergeSDXL",
Expand Down
38 changes: 38 additions & 0 deletions es/built-in-nodes/ModelMergeMOSSImage.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: "ModelMergeMOSSImage - ComfyUI Built-in Node Documentation"
description: "El nodo ModelMergeMOSSImage fusiona dos modelos de imagen MOSS mezclando sus pesos coincidentes bloque por bloque"
sidebarTitle: "ModelMergeMOSSImage"
icon: "circle"
mode: wide
---

El nodo ModelMergeMOSSImage fusiona dos modelos de imagen MOSS mezclando sus pesos coincidentes bloque por bloque, de modo que una parte del resultado puede provenir de un modelo base y el resto de un ajuste fino o de un segundo modelo. Cada componente principal de la arquitectura tiene su propia proporción: el embedder de video, el embedder de texto, el embedding temporal, la modulación de bloque compartida, las 42 capas transformer y las cabeceras de salida.

## Entradas

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| --- | --- | --- | --- | --- |
| `model1` | El primer modelo a fusionar. Todo lo que el segundo modelo no aporta se conserva de este modelo | MODEL | Sí | - |
| `model2` | El segundo modelo a fusionar. Sus pesos se mezclan de acuerdo con las proporciones siguientes | MODEL | Sí | - |
| `video_embedder.` | Proporción de mezcla para el bloque del embedder de video (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `text_embedder.proj.` | Proporción de mezcla para la capa de proyección del embedder de texto (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `text_embedder.blocks.0.` y `text_embedder.blocks.1.` | Proporción de mezcla para cada uno de los dos bloques del embedder de texto (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `time_embedding.` | Proporción de mezcla para el bloque de embedding temporal (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `shared_block_modulation.` | Proporción de mezcla para la capa de modulación compartida utilizada por los bloques transformer (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `layers.0.` hasta `layers.41.` | Proporción de mezcla para cada una de las 42 capas transformer (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `final_norm_video.` | Proporción de mezcla para la normalización final del flujo de video (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `final_linear_video.` | Proporción de mezcla para la capa lineal final del flujo de video (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `video_head_modulation.` | Proporción de mezcla para la capa de modulación de la cabecera de salida de video (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |

Una proporción de 0.0 mantiene ese componente tal como está en `model1`, una proporción de 1.0 lo toma completamente de `model2`, y los valores intermedios producen una mezcla ponderada. Ambas entradas deben ser modelos de imagen MOSS con la misma arquitectura; los pesos que no coincidan con ninguno de los prefijos anteriores usan la proporción de `video_embedder.`.

## Salidas

| Nombre de salida | Descripción | Tipo de datos |
| --- | --- | --- |
| `MODEL` | El modelo fusionado, que combina ambas entradas de acuerdo con las proporciones especificadas | MODEL |

> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelMergeMOSSImage/es.md)

---
**Source fingerprint (SHA-256):** `3b7d9c806a8d53ad00044bf30f5e63431fea7ee565414acb70a56e3059164288`
35 changes: 35 additions & 0 deletions es/built-in-nodes/ModelMergeSD2.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
title: "Fusionar modelo SD 2 - ComfyUI Built-in Node Documentation"
description: "El nodo ModelMergeSD2 fusiona dos modelos Stable Diffusion 2.x mezclando sus componentes correspondientes"
sidebarTitle: "Fusionar modelo SD 2"
icon: "circle"
mode: wide
---

El nodo ModelMergeSD2 fusiona dos modelos Stable Diffusion 2.x mezclando sus componentes correspondientes, con un peso independiente para el embedding de tiempo, el embedding de etiquetas y cada bloque de entrada, central y de salida. La disposición de los bloques es la misma que en ModelMergeSD1, por lo que ambos nodos exponen el mismo conjunto de proporciones.

## Entradas

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
| --- | --- | --- | --- | --- |
| `modelo1` | El primer modelo que se va a fusionar. Todo lo que no aporta el segundo modelo se conserva de este modelo | MODEL | Sí | - |
| `modelo2` | El segundo modelo que se va a fusionar. Sus pesos se mezclan según las proporciones indicadas a continuación | MODEL | Sí | - |
| `time_embed.` | Proporción de mezcla para la capa de embedding de tiempo (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `label_emb.` | Proporción de mezcla para la capa de embedding de etiquetas (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `input_blocks.0.` hasta `input_blocks.11.` | Proporción de mezcla para cada uno de los 12 bloques de entrada (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `middle_block.0.` hasta `middle_block.2.` | Proporción de mezcla para cada uno de los 3 bloques centrales (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `output_blocks.0.` hasta `output_blocks.11.` | Proporción de mezcla para cada uno de los 12 bloques de salida (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |
| `out.` | Proporción de mezcla para la capa de salida (predeterminado: 1.0) | FLOAT | Sí | 0.0 a 1.0 (paso: 0.01) |

Una proporción de 0.0 mantiene ese componente tal como está en `model1`, una proporción de 1.0 lo toma por completo de `model2`, y los valores intermedios producen una mezcla ponderada. Ambas entradas deben ser modelos Stable Diffusion 2.x con la misma estructura de bloques.

## Salidas

| Nombre de salida | Descripción | Tipo de datos |
| --- | --- | --- |
| `MODEL` | El modelo fusionado, que combina ambas entradas según las proporciones especificadas | MODEL |

> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ModelMergeSD2/es.md)

---
**Source fingerprint (SHA-256):** `b9d53f126139412fbd8b21be72e1dcdb02736519ab4dc9e28c7840d69acb7c87`
38 changes: 38 additions & 0 deletions ja/built-in-nodes/ModelMergeMOSSImage.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: "ModelMergeMOSSImage - ComfyUI Built-in Node Documentation"
description: "ModelMergeMOSSImage ノードは、2 つの MOSS 画像モデルを、対応する重みをブロックごとにブレンドすることでマージします。"
sidebarTitle: "ModelMergeMOSSImage"
icon: "circle"
mode: wide
---

ModelMergeMOSSImage ノードは、2 つの MOSS 画像モデルを、対応する重みをブロックごとにブレンドすることでマージします。これにより、結果の一部をベースモデルから、残りをファインチューンまたは 2 番目のモデルから取得できます。アーキテクチャの主要コンポーネントごとに個別の比率があります。ビデオエンベッダー、テキストエンベッダー、時間埋め込み、共有ブロック変調、42 個すべての Transformer レイヤー、および出力ヘッドです。

## 入力

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
| --- | --- | --- | --- | --- |
| `model1` | マージする最初のモデルです。2 番目のモデルが寄与しない部分はすべてこのモデルから保持されます | MODEL | はい | - |
| `model2` | マージする 2 番目のモデルです。その重みは、以下の比率に従ってブレンドされます | MODEL | はい | - |
| `video_embedder.` | ビデオエンベッダーブロックのブレンド比率（デフォルト: 1.0） | FLOAT | はい | 0.0 〜 1.0 （ステップ 0.01） |
| `text_embedder.proj.` | テキストエンベッダーの投影層のブレンド比率（デフォルト: 1.0） | FLOAT | はい | 0.0 〜 1.0 （ステップ 0.01） |
| `text_embedder.blocks.0.` と `text_embedder.blocks.1.` | 2 つのテキストエンベッダーブロックそれぞれのブレンド比率（デフォルト: 1.0） | FLOAT | はい | 0.0 〜 1.0 （ステップ 0.01） |
| `time_embedding.` | 時間埋め込みブロックのブレンド比率（デフォルト: 1.0） | FLOAT | はい | 0.0 〜 1.0 （ステップ 0.01） |
| `shared_block_modulation.` | Transformer ブロックで使用される共有変調層のブレンド比率（デフォルト: 1.0） | FLOAT | はい | 0.0 〜 1.0 （ステップ 0.01） |
| `layers.0.` から `layers.41.` まで | 42 個の Transformer レイヤーそれぞれのブレンド比率（デフォルト: 1.0） | FLOAT | はい | 0.0 〜 1.0 （ステップ 0.01） |
| `final_norm_video.` | ビデオストリームの最終正規化のブレンド比率（デフォルト: 1.0） | FLOAT | はい | 0.0 〜 1.0 （ステップ 0.01） |
| `final_linear_video.` | ビデオストリームの最終線形層のブレンド比率（デフォルト: 1.0） | FLOAT | はい | 0.0 〜 1.0 （ステップ 0.01） |
| `video_head_modulation.` | ビデオ出力ヘッドの変調層のブレンド比率（デフォルト: 1.0） | FLOAT | はい | 0.0 〜 1.0 （ステップ 0.01） |

比率 0.0 はそのコンポーネントを `model1` のまま保持し、比率 1.0 は完全に `model2` から取得し、中間の値は重み付きブレンドを生成します。両方の入力は同じアーキテクチャの MOSS 画像モデルである必要があります。上記のどのプレフィックスにも一致しない重みは、`video_embedder.` の比率にフォールバックします。

## 出力

| 出力名 | 説明 | データ型 |
| --- | --- | --- |
| `MODEL` | 指定された比率に従って両方の入力を組み合わせた、マージ済みモデルです | MODEL |

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

---
**Source fingerprint (SHA-256):** `3b7d9c806a8d53ad00044bf30f5e63431fea7ee565414acb70a56e3059164288`
Loading
Loading