ComfyUI Node
Nano Banana - Unbiased Face Swap
A ComfyUI node in NanoBanana FaceSwap with 28 inputs and 4 outputs.
Nano Banana - Unbiased Face Swap
- target_image
- identity_1
- identity_2
- identity_3
- identity_4
- identity_5
- identity_6
- network
- image
- status
- mask
- debug_sheet
◄api_key►
◄modelgemini-3.1-flash-image-preview►
◄scopeface►
◄custom_hint►
◄seed0►
◄batch_axistarget►
◄detectorauto►
◄mask_dilate_px25►
◄mask_feather_px16►
◄image_size2K►
◄thinking_levelNONE►
◄apply_integratefalse►
◄lab_strength0.60►
◄grain_strength1.00►
◄composite_methodfeather►
◄match_directional_lightingfalse►
◄dry_runfalse►
◄timeout_ms180000►
◄ref_cap_px1024►
◄auto_relax_on_refusedfalse►
CategoryNanoBanana FaceSwap
Inputs (28)
| Name | Type | Default | Description |
|---|---|---|---|
| api_key | STRING | — | |
| model | COMBO | gemini-3.1-flash-image-preview | 3 options: gemini-3.1-flash-image-preview, gemini-3-pro-image-preview, gemini-2.5-flash-image |
| target_image | IMAGE | — | |
| identity_1 | IMAGE | — | |
| scope | COMBO | face | 3 options: face, head, head+styling |
| custom_hint | STRING | — | |
| seed | INT | 00–2147483647 | — |
| batch_axis | COMBO | target | 2 options: target, identity |
| detector | COMBO | auto | 4 options: auto, mediapipe, opencv_yunet, gemini_bbox |
| mask_dilate_px | INT | 250–128 | — |
| mask_feather_px | INT | 160–128 | — |
| image_size | COMBO | 2K | 3 options: 1K, 2K, 4K |
| thinking_level | COMBO | NONE | 4 options: NONE, LOW, MEDIUM, HIGH |
| apply_integrate | BOOLEAN | false | Enable post-process integration stages (LAB color match, grain match, sharpness match, optional lighting transfer). Defaults OFF so the first call isolates the request-shape change. |
| lab_strength | FLOAT | 0.600–1 | — |
| grain_strength | FLOAT | 1.000–2 | — |
| composite_method | COMBO | feather | 2 options: feather, laplacian |
| match_directional_lighting | BOOLEAN | false | Same-character refinement only. Steals the original face's broad lighting envelope and applies it to Gemini's face. Imposes the original person's skull/brow geometry on the new identity in cross-identity swaps. |
| identity_2opt | IMAGE | — | |
| identity_3opt | IMAGE | — | |
| identity_4opt | IMAGE | — | |
| identity_5opt | IMAGE | — | |
| identity_6opt | IMAGE | — | |
| dry_runopt | BOOLEAN | false | — |
| timeout_msopt | INT | 1800005000–600000 | — |
| ref_cap_pxopt | INT | 10240–4096 | — |
| auto_relax_on_refusedopt | BOOLEAN | false | — |
| networkopt | NB_NETWORK | Optional. Wire a NanoBanana - Network Route node here to route this swap's API call through that proxy (e.g. US egress). |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| image | IMAGE | — |
| status | STRING | — |
| mask | MASK | — |
| debug_sheet | IMAGE | — |