Skip to main content

​
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

ModelModel IDUseAPI Docs
Nano Banana Progemini-3-pro-image-previewHigh-quality image generation & multi-image editingView
Nano Banana 2 (Flash)gemini-3.1-flash-image-previewFast generation, lower costView

​
Node Parameters

ParameterTypeRequiredDefaultDescription
api_keystringYes-APIYI token — we recommend a dedicated key with usage cap
promptstringYes-Generation or editing instruction
modelenumYesgemini-3-pro-image-previewModel selection (Pro / Flash)
image_sizeenumNo2KOutput resolution (1K / 2K / 4K)
aspect_ratioenumNo1:1One of 15 aspect ratios
timeout_secondsintNo120Per-request timeout (10-600s)
retry_timesintNo3Retry count on failure (1-20)
seedintNo0Random seed (works with ComfyUI’s seed modes)
image_01 … image_14IMAGENo-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

  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)
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
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.
  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

Nano Banana Pro API

Full model capabilities and API reference

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