A Custom Node that integrates Fal.ai's powerful image editing APIs. This node allows you to edit images using the latest Image Editing Models available via Fal.ai API.

✨ Features

Multi-Model Support: Access multiple editing models from a single node.
Multi-Image Input: Support for up to 5 input images for context-aware editing (model dependent).
Flexible Output: Control aspect ratios, resolution, and batch size.
Cloud Inference: Offloads heavy GPU processing to Fal.ai's cloud infrastructure.

🚀 Supported Models

Model	ID in Node	Description
Nano Banana	`nano_banana`	Fast, efficient editing.
Nano Banana Pro	`nano_banana_pro`	Enhanced quality version of Nano Banana.
Nano Banana 2	`nano_banana_2`	New generation model with web search and thinking options.
Grok Imagine Edit	`grok_imagine_edit`	xAI image edit model, up to 3 input images.
Seedream 4.5	`seedream_4.5`	ByteDance's model. Optimized for high-res editing.
Seedream 5 Pro Edit	`seedream_5`	ByteDance Seedream 5.0 Pro region-precise editing.
Seedream 5 Lite Edit	`seedream_5_lite`	ByteDance Seedream 5.0 Lite editing.
Qwen Edit Plus	`qwen_edit_plus`	Powerful instruction-based editing with guidance control.
Flux 2 (Standard, Pro, Flex)	`flux_2_edit`	(BFL) High-fidelity editing capabilities.
Flux 2 Klein 9B Edit	`flux_2_klein_9b_edit`	Fast FLUX.2 Klein 9B image editing model.

📦 Installation

Navigate to your ComfyUI custom_nodes directory:
```
cd /path/to/ComfyUI/custom_nodes/
```

Clone this repository (or unzip the folder containing these files):

git clone [https://github.com/yourusername/ComfyUI-NanoSeed.git](https://github.com/yourusername/ComfyUI-NanoSeed.git)

Install dependencies:
```
pip install -r requirements.txt
```

🔑 Configuration

You must have a Fal.ai API Key to use this node.

Go to fal.ai and generate an API Key.
Enter this key into the fal_key widget on the node.

🎛️ Usage

Inputs

prompt: (Required) A text description of how to edit the image.
model: Select the specific AI model to use.
fal_key: Your API key.
image1 - image5: Connect the images you want to edit.

Settings

width / height: Output resolution.
- Note: nano_banana models ignore this and use aspect_ratio.
- Note: seedream_4.5 requires high resolutions (see constraints below).
num_images: How many variations to generate (Max 6).
num_inference_steps: Number of inference steps for supported models.
seed: Seed for reproducibility.
aspect_ratio: Set target aspect ratio (e.g., 16:9, 1:1).
enable_web_search: Enables web search context for supported models.
thinking_level: off, minimal, or high for supported models.

⚠️ Model Specific Constraints

Different models have different requirements implemented in the node:

Flux 2 Edit (flux_2_edit):
- Single Image Only: Do not connect image2 through image5.
- Resolution: Width and Height must be between 512px and 2048px.
Flux 2 Klein 9B Edit (flux_2_klein_9b_edit):
- Supports up to 4 input images.
- num_inference_steps is limited to 4-8.
Seedream 4.5 (seedream_4.5):
- High Res Only: Width and Height must be between 1920px and 4096px.
- Pixel Count: Total pixels (W x H) must be between ~3.6MP and 16.7MP.
- Batch Limit: The sum of input images and output num_images cannot exceed 15.
Seedream 5 Pro Edit (seedream_5):
- Supports up to 10 input images.
- If aspect_ratio is not auto, the selected aspect ratio is prioritized and converted to Seedream's image_size.
- If aspect_ratio is auto, the selected resolution is mapped to Seedream's automatic size presets.
- Pro supports auto_1K and auto_2K; 4K falls back to Pro's highest automatic preset.
Seedream 5 Lite Edit (seedream_5_lite):
- Supports up to 10 input images.
- Uses the same aspect-ratio-first behavior as Seedream 5 Pro.
- Supports Lite automatic presets up to auto_4K.
Nano Banana / Pro / 2:
- These models rely on aspect_ratio and resolution settings rather than custom width/height integers.
- nano_banana_2 supports 0.5K, 1K, 2K, and 4K resolution presets.
- nano_banana_2 also supports extended aspect ratios: 4:1, 1:4, 8:1, and 1:8.
Grok Imagine Edit (grok_imagine_edit):
- Supports up to 3 input images.
- Uses up to 4 output images.

🛠️ Troubleshooting

"No images returned from API": Check your fal_key balance or ensure your prompt is not triggering safety filters.
Resolution Errors: If using Seedream, ensure your resolution is set high enough (min 1920x1920). If using Flux, ensure it is within 512-2048.

Star this repo if it helps your workflow! 🚀