Luck Nano Banana Pro - ComfyUI Node

A community-contributed advanced ComfyUI node: up to 14 reference images, 1K/2K/4K output, 15 aspect ratios, configurable retry/timeout — built for production.

Overview

Comfyui-LuckNanoBananaPro is a ComfyUI custom node contributed by community user luckdvr. It calls Gemini 3 Pro Image Preview / Flash through APIYI for text-to-image and multi-image editing. Compared to basic nodes, its biggest strength is engineering polish: built-in timeout/retry, real-time progress, native ComfyUI seed modes, and up to 14 stacked image inputs — ideal for heavier production workflows.

Project Info

• 🔗 Source: github.com/luckdvr/Comfyui-LuckNanoBananaPro
• 📜 License: MIT / Apache-2.0 (dual)
• 👤 Author: luckdvr
• ⭐ Community contribution, built for APIYI

How to pick among the three ComfyUI nodes?

Three community ComfyUI nodes for Nano Banana are available — pick the right one:

• Nano Banana ComfyUI Nodes: full-featured (conversational editing, multi-turn memory), great for interactive creation
• APIYI Nano Banana Node (Lite): minimal codebase, great for learning and customization
• Luck Nano Banana Pro (this page): engineering-rich parameters (timeout, retry, 14 image inputs), built for stable production

Core Features

Up to 14 image inputs

image_01 ~ image_14 slots stack up to 14 reference images, matching Nano Banana Pro’s theoretical input ceiling

Multi-tier resolution

1K / 2K / 4K output with adaptive timeout — balance speed and quality

15 aspect ratios

Rich presets covering vertical, horizontal, square, and cinematic widescreen

Dual-model switch

Toggle between gemini-3-pro-image-preview (Pro) and gemini-3.1-flash-image-preview (Flash)

Timeout & retry

timeout_seconds (10-600s) + retry_times (1-20) — stable even at peak hours

Real-time progress

Built-in status / percentage / elapsed-time display — no more black-box runs

Native seed modes

Supports ComfyUI’s standard fixed / random / increment / decrement seed patterns

MIT / Apache-2.0 dual license

Permissive license — commercial and derivative work welcome

Supported APIYI Models

Model	Model ID	Use	API Docs
Nano Banana Pro	gemini-3-pro-image-preview	High-quality image generation & multi-image editing	View
Nano Banana 2 (Flash)	gemini-3.1-flash-image-preview	Fast generation, lower cost	View

Node Parameters

Parameter	Type	Required	Default	Description
api_key	string	Yes	-	APIYI token — we recommend a dedicated key with usage cap
prompt	string	Yes	-	Generation or editing instruction
model	enum	Yes	gemini-3-pro-image-preview	Model selection (Pro / Flash)
image_size	enum	No	2K	Output resolution (1K / 2K / 4K)
aspect_ratio	enum	No	1:1	One of 15 aspect ratios
timeout_seconds	int	No	120	Per-request timeout (10-600s)
retry_times	int	No	3	Retry count on failure (1-20)
seed	int	No	0	Random seed (works with ComfyUI’s seed modes)
image_01 … image_14	IMAGE	No	-	Optional reference images (up to 14)

Installation

1. Step 1: Clone into custom_nodes

   Inside your ComfyUI install:

   cd ComfyUI/custom_nodes
   git clone https://github.com/luckdvr/Comfyui-LuckNanoBananaPro.git
   
2. Step 2: Install dependencies

   cd Comfyui-LuckNanoBananaPro
   python3 -m pip install -r requirements.txt
   
3. Step 3: Restart ComfyUI

   Search Luck Nano Banana Pro in the node palette to find it.

4. Step 4: Configure APIYI key

   • Visit APIYI Console → Tokens, create a dedicated key with a usage cap (best practice)
   • Paste the key into the api_key field
   • The node already points at api.apiyi.com — no endpoint setup required
5. Step 5: Build your workflow

   • Text-to-image: just set prompt, leave image inputs empty
   • Multi-image editing: wire multiple Load Image into image_01, image_02, etc., with a prompt describing the edit

Usage Examples

Example 1: High-stability text-to-image

prompt: "Cinematic product shot of a minimalist ceramic teacup on a wooden tray, soft morning light, 35mm lens, shallow depth of field"
model: gemini-3-pro-image-preview
image_size: 4K
aspect_ratio: 3:2
timeout_seconds: 300
retry_times: 5

Example 2: Multi-image blending

image_01: person photo
image_02: outfit reference
image_03: scene reference
image_04: lighting reference
prompt: "Photorealistic portrait: subject from image_01 wearing outfit from image_02, in the setting of image_03, with lighting style of image_04"
image_size: 2K
aspect_ratio: 4:5

Example 3: Seed sweeps

Use ComfyUI’s native seed management in increment mode to batch-run multiple seeds and compare variations of the same prompt.

FAQ

Node not found after installing?

1. Confirm the repo lives at ComfyUI/custom_nodes/Comfyui-LuckNanoBananaPro
2. Dependencies installed without errors (requests / Pillow / numpy especially)
3. Fully restart ComfyUI (refresh alone is not enough)

4K times out often?

The node lets you tune timeout_seconds directly:

• Start with timeout_seconds=300 for 4K
• Pair with retry_times=5 for automatic retries against network jitter
• If still flaky, see CDN image/video downloads are slow to optimize your network path

Will all 14 reference images be used?

You can wire up to 14, but whether they’re actually used depends on your prompt. Reference them explicitly in the prompt (e.g., image_01, image_02) or describe each one’s role — the model will pick up on your instructions.

Calls return 401 / 403?

1. Check api_key and ensure it’s not restricted to the wrong channel
2. Selected model must be on the token’s whitelist
3. Account balance — see Balance seems enough but calls fail

How is this different from the other two Nano Banana ComfyUI nodes?

• nano-banana-comfyui (full-featured): emphasizes conversational editing and multi-turn memory
• apiyi-nano-banana-node (lite): minimal code, great for learning/customization
• Luck Nano Banana Pro (this page): engineering parameters (timeout / retry / 14 images), built for batch and production

Related Resources

Nano Banana Pro API

Full model capabilities and API reference

Luck GPT-Image 2 (same author)

luckdvr’s OpenAI-line ComfyUI nodes: gpt-image-2 + gpt-image-2-all

ComfyUI node collection

Browse all Nano Banana ComfyUI nodes

FAQ: CDN download slow

4K images downloading slowly? Read this

APIYI Console

Manage keys, usage, and channels