<pre><code>This covers the installation of SAM3.1. Instead of selecting "Bypass" for everything, choose only the components you wish to use. Instructions are provided in Markdown format, so please translate them into your preferred language for use.

# Krea 2 Turbo — Upscaler + Detailer Workflow `v3.1`

Krea 2 Turbo で **生成 → 拡大 → 顔補正** までを 1 本で完結させる ComfyUI ワークフローです。
各工程はサブグラフ／グループに分かれていて、**Ctrl+B か Fast Groups Bypasser で個別にオン・オフ**できます。
不要な工程を切れば、そのまま「生成だけ」「補正だけ」のワークフローとしても使えます。

```
Krea2Turbo 1040x1440 / 9 steps / cfg 1.0
 ↓
Identity Edit 指示文で編集 (既定オフ)
 ↓
Upscaler 4x-UltraSharp → 0.3125x → 1300x1800
 ↓
Hires Fix 低 denoise の仕上げパス (既定オフ)
 ↓
Face Detailer YOLO で顔検出 → 768px で描き直し
 ↓
SAM3.1 Detailer テキストで対象指定 + 除外プロンプト (既定オフ)
 ↓
SaveImage 1300x1800
```

---

## 1. 必要なもの

### カスタムノード（ComfyUI Manager からインストール）

| 名前 | 用途 | 必須 |
|---|---|---|
| rgthree-comfy | Power Lora Loader / Image Comparer / Fast Groups Bypasser | ○ |
| ComfyUI-Impact-Pack | FaceDetailer / DetailerForEach | ○ |
| ComfyUI-Impact-Subpack | UltralyticsDetectorProvider（YOLO 顔検出） | ○ |
| ComfyUI-FreeMemory | Memory Clear ノード | △ |
| comfyui-krea2edit | Identity Edit グループ用 | △ |
| KreaSeedVarianceEnhancer | Seed Variance グループ用 | △ |

△ は既定でバイパスされているグループ用なので、**なくてもワークフローは動きます**。
Memory Clear だけは本線上にありますが、IMAGE を素通しするだけなので削除して繋ぎ直しても問題ありません。

SAM 3.1 は **ComfyUI 本体に統合済み**です。カスタムノードは不要ですが、本体を最新版に更新してください。

### モデル配置

```
ComfyUI/models/
├─ diffusion_models/ krea2_turbo_fp8_scaled.safetensors
├─ text_encoders/ qwen3vl_4b_fp8_scaled.safetensors
├─ vae/ qwen_image_vae.safetensors
├─ upscale_models/ 4x-UltraSharp.pth
├─ ultralytics/bbox/ face_yolov8m.pt
├─ checkpoints/ sam3.1_multiplex_fp16.safetensors ← SAM3.1 グループを使う場合のみ
└─ loras/ krea2_identity_edit_v1_2.safetensors ← Identity Edit を使う場合のみ
```

- krea2_turbo_fp8_scaled … https://huggingface.co/Comfy-Org/Krea-2/tree/main/diffusion_models
- qwen3vl_4b_fp8_scaled … https://huggingface.co/Comfy-Org/Qwen3-VL/tree/main/text_encoders
- qwen_image_vae … https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/tree/main/split_files/vae
- sam3.1_multiplex_fp16（約 1.75GB）… https://huggingface.co/Comfy-Org/sam3.1
- `4x-UltraSharp` / `face_yolov8m` は ComfyUI Manager の Model Manager から検索してインストールできます

&gt; モデル名が赤く「Value not in list」になる場合は、ファイル名かフォルダが違うだけです。
&gt; ノードのドロップダウンから自分の環境のファイルを選び直してください。

---

## 2. 使い方（最短手順）

1. ワークフローを読み込む
2. `Krea2Turbo` ノードの **Positive Prompt** を書き換える
3. 必要なら `Power Lora Loader` の **Add Lora** から LoRA を追加（**既定は空**）
4. Queue Prompt

出力は `ComfyUI/output/Krea2Turbo/` に保存されます。
`Preview (仕上げ後 vs Hires 前)` のスライダーで、**補正後 / 生成そのまま**を左右比較できます。

### 既定のオン・オフ

| グループ | 既定 | 備考 |
|---|---|---|
| Krea2Turbo（ベース生成） | **ON** | |
| Upscaler | **ON** | 4x 拡大 → 縮小、UNet 評価ゼロ |
| Face Detailer | **ON** | YOLO で顔を検出して描き直し |
| SAM3.1 Detailer | OFF | 使うにはモデル追加DLが必要 |
| SAM3.1 Negative（除外） | OFF | SAM3.1 Detailer と一緒に ON |
| Hires Fix (2nd Pass) | OFF | 品質重視のとき ON |
| Krea 2 Identity Edit | OFF | 追加ノード + LoRA が必要 |
| Seed Variance Enhancer | OFF | 追加ノードが必要 |
| 既存画像を読み込む | OFF | ON にすると生成せず補正だけ回せる |

切り替えは画面左上の **Fast Groups Bypasser** のスイッチが一番早いです。

&gt; **バイパスは必ずグループ単位で。**
&gt; `Upscale Model` など単体ノードだけをオフにすると
&gt; `Required input is missing: upscale_model` になります。

---

## 3. 各グループの説明

### Krea2Turbo（ベース生成）
モデル・CLIP・VAE のロードと 1st パス。解像度・プロンプト・steps はこのノードの表面に出ています。

| つまみ | 既定 | メモ |
|---|---|---|
| width / height | 1040 x 1440 | 16 の倍数で |
| steps | 9 | Turbo なので 6〜10 で十分 |
| cfg | 1.0 | **1.0 ではネガティブは効きません**（蒸留モデルの仕様） |
| neg_strength / neg_end | 1.0 / 0.5 | cfg を 1.5 に上げたときの効き具合 |

ネガティブを効かせたいときだけ `cfg` を 1.5 に。**生成時間は約 2 倍**になります。

### Upscaler
`ImageUpscaleWithModel(4x) → ImageScaleBy(0.3125)` で 1040x1440 → **1300x1800**。
拡散を通さないので UNet 評価はゼロ、時間はほぼかかりません。
`scale_by = 目標倍率 ÷ 4` です。1.5倍なら 0.375、2倍なら 0.5。

### Hires Fix (2nd Pass) — 既定 OFF
Upscaler の**後段**で低 denoise の仕上げパスを走らせます（`scale_by` は 1.0 固定なので二重拡大にはなりません）。
`denoise` 0.11 が既定。0.08〜0.15 は構図維持、0.20〜0.30 でディテールが増えるかわりに細部が変わります。

### Face Detailer
YOLO で顔を検出し、その領域だけ 768px で再生成して合成します。
`denoise` 0.15 が既定。別人になるなら 0.10、もっとくっきりさせたいなら 0.25。

### SAM3.1 Detailer — 既定 OFF
YOLO の代わりに **テキストで検出対象を指定**する Detailer です。

```
SAM3.1 Prompt face:99,
```

`:99` は「99 個まで検出」の意味で、**付けないと 1 個しか検出されません**。
`face:99, hand:99` のようにカンマ区切りで複数指定できます。
`SAM3.1 Detection Preview` で、白く光っている＝描き直される範囲を事前に確認できます。

Face Detailer と顔で併用すると二重処理になるので、**顔に使うならどちらか一方**にしてください。

### SAM3.1 Negative（除外プロンプト）— `v3.1` で追加 / 既定 OFF
ComfyUI の `SAM3_Detect` には **ネガティブ「テキスト」入力がありません**
（あるのは `negative_coords` = 除外したい座標だけ）。
そこで **同じ画像をもう一度検出して、その領域をマスクから引き算する**構成にしています。

```
CLIPTextEncode (negative) → SAM3_Detect (negative) ─┐
 ▼
SAM3_Detect (positive) ────→ MaskComposite (subtract) → GrowMask → SEGS → Detailer
```

使い方:

1. Fast Groups Bypasser で `SAM3.1 Negative (除外プロンプト)` を ON
2. `SAM3.1 Negative Prompt` に除外したい対象を書く（例 `hand:99,` `glasses:99,`）
3. Detection Preview でマスクを確認

| 症状 | 対処 |
|---|---|
| 除外しきれない | negative 側の `threshold` を 0.5 → 0.3 に下げる |
| 消したくない所まで消える | negative 側の `threshold` を上げる |
| 輪郭ギリギリを残したい | `GrowMask` の expand を 8 → 4〜6 に |

OFF のときは `MaskComposite` が destination をそのまま通すので、**v3.0 と完全に同じ動作**です。

### Krea 2 Identity Edit — 既定 OFF
英語の指示文で、人物の同一性を保ったまま服・背景・ライティングを変えます。
`krea2_identity_edit_v1_2.safetensors` と `comfyui-krea2edit` が必要です。

### 生成せずに補正だけ回す
`既存画像を読み込む` を Ctrl+B で有効化するだけ。`Any Switch` が自動で読込画像側に切り替わります。
（ベース生成自体は止まらないので、完全に止めたいときは `Krea2Turbo` の steps を 1 に）

---

## 4. パラメータ早見表

| やりたいこと | 触る場所 | 方向 |
|---|---|---|
| 顔の同一性を保ちたい | Face Detailer の `denoise` | 0.15 → 0.10 |
| 顔をもっとくっきり | Face Detailer の `denoise` | 0.15 → 0.25 |
| 出力をもっと大きく | Upscaler の `scale_by` | 0.3125 → 0.375 |
| ディテールを増やしたい | `Hires Fix` を ON | 遅くなります |
| 手を直したい | SAM3.1 に `hand:99` | — |
| 特定の対象だけ除外したい | SAM3.1 Negative | — |
| 速くしたい | SAM3.1 / Identity Edit を OFF | — |
| VRAM が足りない | Upscaler の `scale_by` | 0.3125 → 0.25 |
| ネガティブを効かせたい | Krea2Turbo の `cfg` | 1.0 → 1.5（約2倍遅い） |

---

## 5. よくあるエラー

| 症状 | 原因と対処 |
|---|---|
| `Required input is missing` | 単体ノードをバイパスした。**グループ単位**でオフにする |
| `Value not in list` | モデルのファイル名／フォルダ違い。ドロップダウンから選び直す |
| 補正が効いていない | 対象グループが紫（バイパス）になっていないか確認 |
| SAM3.1 が 1 個しか検出しない | プロンプトに `:99` が付いていない |
| OOM / 極端に遅い | `scale_by` を下げる、SAM3.1 / Identity Edit を OFF、`PYTORCH_CUDA_ALLOC_CONF=expandable_segments:True` |

ワークフロー内にも README / パラメータ調整ガイド / トラブルシューティングの
Markdown ノートを同梱しています。詳しくはそちらを参照してください。
</code></pre><h3 id="english">English</h3>Krea 2 Turbo — Hires + Detailer WorkflowOne graph that takes Krea 2 Turbo from a base generation to a finished 1560×2160 image: generate, upscale and re-diffuse, then redraw the faces and hands. Everything after the base generation is its own group, so you can Ctrl+B anything you don't need and get the render time back.New in v1.1 is a SAM3 Detailer. Instead of loading a trained YOLO detector for every part you want to fix, you type it — <code>face, hand</code>, <code>eyes, mouth</code>, <code>necklace, earrings</code>. SAM3 finds the region, Impact Pack redraws it.Pipeline<ul><li>Krea 2 Turbo — 1040×1440, 8 steps, cfg 1.0, er_sde / simple</li><li>Hires Fix — lanczos ×1.5 → 1560×2160, 12 steps, denoise 0.25</li><li>Face Detailer — face_yolov8m, guide 768, denoise 0.25</li><li>Hand Detailer — hand_yolov8s, guide 512, denoise 0.30</li><li>SAM3 Detailer (new) — text prompt, guide 1024, denoise 0.25</li><li>Save Image — 1560×2160</li></ul>An Image Comparer is wired in, so you can slide between the detailed result and the raw generation.Custom nodes<ul><li>rgthree-comfy — Power Lora Loader, Image Comparer, Fast Groups Bypasser</li><li>ComfyUI-Impact-Pack — FaceDetailer, Detailer (SEGS), MaskToSEGS</li><li>ComfyUI-Impact-Subpack — UltralyticsDetectorProvider</li><li>ComfyUI-Easy-Sam3 — SAM3 nodes, only needed for the SAM3 group</li></ul>Load the JSON without these and ComfyUI Manager will offer to install what's missing. The SAM3 group ships bypassed, so the workflow runs before you've set SAM3 up.Models<ul><li><code>models/diffusion_models/krea2_turbo_fp8_scaled.safetensors</code></li><li><code>models/text_encoders/qwen3vl_4b_fp8_scaled.safetensors</code></li><li><code>models/vae/qwen_image_vae.safetensors</code></li><li><code>models/ultralytics/bbox/face_yolov8m.pt</code> + <code>hand_yolov8s.pt</code></li><li><code>models/sam3/sam3-fp16.safetensors</code></li></ul>The first three come from Comfy-Org/Krea-2 on Hugging Face. The YOLO detectors install from Manager's Model Manager. For SAM3, the safetensors build (yolain/sam3-safetensors) needs no access request; Meta's official <code>sam3.pt</code> works too but requires approval on Hugging Face.How to use<ol><li>Open the <code>Krea2Turbo</code> subgraph and rewrite the positive prompt.</li><li>Add LoRAs in Power Lora Loader if you want — it's empty by default.</li><li>Enable the groups you need in Fast Groups Bypasser.</li><li>Queue.</li></ol>Tuning<ul><li>Image changes too much → Hires Fix denoise 0.25 → 0.15</li><li>Keep the face identity → Face Detailer denoise 0.25 → 0.20</li><li>Bigger output → ImageScaleBy scale_by 1.5 → 2.0</li><li>Out of VRAM → scale_by 1.5 → 1.25</li><li>Faster → base steps 8 → 6, bypass Hand Detailer</li><li>Leave cfg at 1.0. Krea 2 Turbo is distilled; raising it burns the image.</li></ul>BypassingToggle whole groups, not single nodes. Bypassing a lone <code>Hand Detector</code> leaves <code>bbox_detector</code> unconnected and the run fails. VAEEncode / VAEDecode change types, so they can't be passed through either. The groups are built so IMAGE and CONDITIONING travel straight through — use those.SAM3 or YOLO?Same job, different trade-off. SAM3 needs no per-target model and handles anything you can name; YOLO is lighter on VRAM and well proven on faces. Running both redraws the same pixels twice and softens them — pick one.CreditsThe JSON is free to use, modify and redistribute; a credit is appreciated. The models and custom nodes it depends on carry their own licenses — check the source before anything commercial.Krea 2 Turbo / Qwen3-VL / Qwen-Image VAE — Comfy-Org · SAM3 — Meta · Impact-Pack / Subpack — ltdrdata · Easy-Sam3 — yolain · rgthree-comfy — rgthree<hr /><h3>日本語</h3>Krea 2 Turbo — Hires + Detailer ワークフローKrea 2 Turbo で 生成 → 高解像度化 → 顔と手の描き直し までを 1 本で行い、1560×2160 で出力します。ベース生成より後ろはすべてグループに分かれているので、要らない工程は Ctrl+B で切ればそのぶん速くなります。v1.1 で追加したのが SAM3 Detailer です。直したい部分ごとに YOLO の検出モデルを用意する代わりに、<code>face, hand</code> <code>eyes, mouth</code> <code>necklace, earrings</code> のように言葉で書くだけで対象を指定できます。処理の流れ<ul><li>Krea 2 Turbo — 1040×1440 / 8 steps / cfg 1.0 / er_sde・simple</li><li>Hires Fix — lanczos ×1.5 → 1560×2160 / 12 steps / denoise 0.25</li><li>Face Detailer — face_yolov8m / guide 768 / denoise 0.25</li><li>Hand Detailer — hand_yolov8s / guide 512 / denoise 0.30</li><li>SAM3 Detailer(新規) — テキスト指定 / guide 1024 / denoise 0.25</li><li>Save Image — 1560×2160</li></ul>Image Comparer を繋いであるので、スライダーで補正後と生成そのままを比較できます。必要なカスタムノード<ul><li>rgthree-comfy — Power Lora Loader / Image Comparer / Fast Groups Bypasser</li><li>ComfyUI-Impact-Pack — FaceDetailer / Detailer (SEGS) / MaskToSEGS</li><li>ComfyUI-Impact-Subpack — UltralyticsDetectorProvider</li><li>ComfyUI-Easy-Sam3 — SAM3 ノード(SAM3 グループを使う場合のみ)</li></ul>未導入のまま読み込むと ComfyUI Manager が不足分のインストールを提案します。SAM3 グループは既定でバイパスしてあるので、SAM3 を用意する前でもワークフローは動きます。モデルの配置<ul><li><code>models/diffusion_models/krea2_turbo_fp8_scaled.safetensors</code></li><li><code>models/text_encoders/qwen3vl_4b_fp8_scaled.safetensors</code></li><li><code>models/vae/qwen_image_vae.safetensors</code></li><li><code>models/ultralytics/bbox/face_yolov8m.pt</code> と <code>hand_yolov8s.pt</code></li><li><code>models/sam3/sam3-fp16.safetensors</code></li></ul>上 3 つは Hugging Face の Comfy-Org/Krea-2 から。YOLO は Manager の Model Manager で <code>face_yolov8m</code> / <code>hand_yolov8s</code> を検索してインストールできます。SAM3 は safetensors 版なら申請不要、本家の <code>sam3.pt</code> を使う場合は Hugging Face での利用申請が必要です。使い方<ol><li><code>Krea2Turbo</code> サブグラフをダブルクリックして中に入り、Positive Prompt を書き換える</li><li>必要なら Power Lora Loader に LoRA を追加(既定は空)</li><li>Fast Groups Bypasser で使いたいグループを有効化</li><li>Queue</li></ol>調整の目安<ul><li>絵が変わりすぎる → Hires Fix の denoise を 0.25 → 0.15</li><li>顔の同一性を保ちたい → Face Detailer の denoise を 0.25 → 0.20</li><li>もっと大きく出したい → ImageScaleBy の scale_by を 1.5 → 2.0</li><li>VRAM が足りない → scale_by を 1.5 → 1.25</li><li>速くしたい → ベース steps を 8 → 6、Hand Detailer をバイパス</li><li>cfg は 1.0 のまま。 蒸留モデルなので上げると破綻します</li></ul>バイパスの作法必ずグループ単位でオフにしてください。<code>Hand Detector</code> だけを個別に切ると <code>bbox_detector</code> が欠落してエラーになります。VAEEncode / VAEDecode は入出力の型が変わるため素通りできません。グループは IMAGE / CONDITIONING が素通りする構造にしてあります。SAM3 と YOLO のどちらを使うか役割は同じです。SAM3 は対象ごとのモデルが不要で融通が利き、YOLO は軽くて顔には実績があります。両方を有効にすると同じ場所を二度描き直してかえって眠くなるので、どちらか一方にするのがおすすめです。クレジットJSON は自由に使用・改変・再配布して構いません(出典を書いていただけると嬉しいです)。ただし依存するモデル・カスタムノードにはそれぞれの配布元のライセンスが適用されるので、商用利用の可否は各配布元をご確認ください。Krea 2 Turbo / Qwen3-VL / Qwen-Image VAE — Comfy-Org · SAM3 — Meta · Impact-Pack / Subpack — ltdrdata · Easy-Sam3 — yolain · rgthree-comfy — rgthree

Krea 2 Turbo — Hires + Detailer Workflow (SAM3)

Files with SHA256: 7721f492aec5d3a476b0b28b9782b6cca694f9d364cd8d4f515f4688a8180ae3