ComfyUI NanoSeed Edit

A Custom Node that integrates Fal.ai's powerful image editing APIs. This node allows you to edit images using natural language prompts via state-of-the-art models like Flux2 (standard, Pro, Flex), Qwen, Seedream 4.5, and Nano Banana 1/Pro. <img width="925" height="464" alt="image" src="https://github.com/user-attachments/assets/e8cce9fc-dacb-4027-a1cf-4e29ace68329" />

✨ 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. | | Seedream 4.5 | seedream_4.5 | ByteDance's model. Optimized for high-res 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. |

📦 Installation

1. Navigate to your ComfyUI custom_nodes directory:

   cd /path/to/ComfyUI/custom_nodes/
   

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

3. Install dependencies:

   pip install -r requirements.txt
   

🔑 Configuration

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

1. Go to fal.ai and generate an API Key.
2. 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).
• seed: Seed for reproducibility.
• aspect_ratio: Set target aspect ratio (e.g., 16:9, 1:1).

⚠️ Model Specific Constraints

Different models have different requirements implemented in the node:

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

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

3. Nano Banana / Pro:

   • These models rely on aspect_ratio and resolution (1K/2K/4K) settings rather than custom width/height integers.

🛠️ 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! 🚀