84 lines
3.7 KiB
Markdown
84 lines
3.7 KiB
Markdown
# ComfyUI NanoSeed Edit
|
|
|
|
 
|
|
|
|
A Custom Node that integrates [Fal.ai's](https://fal.ai) 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:
|
|
```bash
|
|
cd /path/to/ComfyUI/custom_nodes/
|
|
```
|
|
2. Clone this repository (or unzip the folder containing these files):
|
|
```bash
|
|
git clone [https://github.com/yourusername/ComfyUI-NanoSeed.git](https://github.com/yourusername/ComfyUI-NanoSeed.git)
|
|
```
|
|
3. Install dependencies:
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
## 🔑 Configuration
|
|
|
|
You must have a **Fal.ai API Key** to use this node.
|
|
|
|
1. Go to [fal.ai](https://fal.ai/dashboard/keys) 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! 🚀*
|