ComfyUI Node
Nano Banana - Face Swap (Whole Image)
A ComfyUI node in NanoBanana FaceSwap with 21 inputs and 4 outputs.
Nano Banana - Face Swap (Whole Image)
- 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►
◄grid_modeseparate_refs►
◄custom_hint►
◄safety_thresholdBLOCK_NONE►
◄seed0►
◄batch_axistarget►
◄image_size2K►
◄dry_runfalse►
◄timeout_ms180000►
◄ref_cap_px1024►
◄auto_relax_on_refusedfalse►
CategoryNanoBanana FaceSwap
Inputs (21)
| 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 |
| grid_mode | COMBO | separate_refs | 2 options: separate_refs, auto_sheet |
| custom_hint | STRING | — | |
| safety_threshold | COMBO | BLOCK_NONE | 4 options: BLOCK_NONE, BLOCK_ONLY_HIGH, BLOCK_MEDIUM_AND_ABOVE, BLOCK_LOW_AND_ABOVE |
| seed | INT | 00–2147483647 | — |
| batch_axis | COMBO | target | 2 options: target, identity |
| image_size | COMBO | 2K | 3 options: 1K, 2K, 4K |
| identity_2opt | IMAGE | — | |
| identity_3opt | IMAGE | — | |
| identity_4opt | IMAGE | — | |
| identity_5opt | IMAGE | — | |
| identity_6opt | IMAGE | — | |
| dry_runopt | BOOLEAN | false | Skip the API call and return a structured preview of the prompt + parts that would have been sent. Burns no quota; useful for debugging custom_hint and prompt builders. |
| timeout_msopt | INT | 1800005000–600000 | Per-call API timeout in milliseconds. Lower (e.g. 30000) lets you fail fast on stuck calls; higher tolerates slow Pro-tier renders. |
| ref_cap_pxopt | INT | 10240–4096 | Downscale identity reference images so their longest edge is at most this many pixels before send. 0 = disabled. 1024 saves bandwidth and empirically improves identity transfer (4K pore detail confuses the model). |
| auto_relax_on_refusedopt | BOOLEAN | false | If the model refuses, retry once with no safety_settings (model defaults). Some BLOCK_NONE refusals relax under defaults. |
| 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 | — |