Image Edit

# Image Edit — Pro Pack on RunComfy

[runcomfy.com](https://www.runcomfy.com/?utm_source=skills.sh&utm_medium=skill&utm_campaign=image-edit) · [Nano Banana Edit](https://www.runcomfy.com/models/google/nano-banana-2/edit?utm_source=skills.sh&utm_medium=skill&utm_campaign=image-edit) · [GPT Image 2 Edit](https://www.runcomfy.com/models/openai/gpt-image-2/edit?utm_source=skills.sh&utm_medium=skill&utm_campaign=image-edit) · [Flux Kontext](https://www.runcomfy.com/models/blackforestlabs/flux-1-kontext-pro/image-to-image?utm_source=skills.sh&utm_medium=skill&utm_campaign=image-edit) · [Z-Image Inpaint](https://www.runcomfy.com/models/tongyi-mai/z-image/turbo/inpainting?utm_source=skills.sh&utm_medium=skill&utm_campaign=image-edit) · [GitHub](https://github.com/agentspace-so/runcomfy-skills/tree/main/image-edit)

**Image edit, intent-routed.** This skill doesn't lock you to one model — it picks the right edit model in the RunComfy catalog based on what the user actually wants: batch identity-preservation, multilingual text rewrite, single-shot precise edit, or mask-driven region replacement.

```bash npx skills add agentspace-so/runcomfy-skills --skill image-edit -g ```

## Pick the right model for the user's intent

| User intent | Model | Why | |---|---|---| | Batch edit 1–20 images consistently (SKU gallery, A/B variants) | **Nano Banana Edit** | Up to 20 input images per call; locked aspect/resolution for series | | Swap background, preserve subject identity | **Nano Banana Edit** | Strong identity preservation under "keep X unchanged" prompts | | Localized object removal / addition with spatial language ("the left object", "upper-right corner") | **Nano Banana Edit** | Honors directional spatial scope | | Multilingual / non-Latin in-image text rewrite (Japanese kana, Cyrillic, Arabic) | **GPT Image 2 Edit** | Strongest in class for multilingual typography | | Multi-reference composition (subject from img1, scene from img2, palette from img3) | **GPT Image 2 Edit** | Numbered refs route cues correctly | | Layout-precise repositioning ("move headline from top-right to bottom-center") | **GPT Image 2 Edit** | Directional language honored at layout level | | Identity preservation across translated headline variants | **GPT Image 2 Edit** | Same source asset → many language variants, identity stable | | Single-shot precise local edit ("she's now holding an orange umbrella") | **Flux Kontext Pro** | Single-ref single-instruction, high-fidelity preservation | | Mask-driven object removal (cables, watermarks, distractions) | **Z-Image Turbo Inpaint** | Mask-required, strength-tunable, edge-consistent | | Mask-driven region replacement (full background swap with mask) | **Z-Image Turbo Inpaint** | High strength + clean mask = clean replacement | | Default if unspecified | **Nano Banana Edit** | Most flexible, supports both single and batch |

The agent reads this table, classifies the user's intent, and picks the matching subsection below.

## Prerequisites

1. **RunComfy CLI** — `npm i -g @runcomfy/cli` 2. **RunComfy account** — `runcomfy login`. 3. **CI / containers** — set `RUNCOMFY_TOKEN=<token>`.

---

## Route 1: Nano Banana Edit — default for general edit + batch

**Model**: `google/nano-banana-2/edit`

### Schema

| Field | Type | Required | Default | Notes | |---|---|---|---|---| | `prompt` | string | yes | — | Lead with preservation goals, end with the change. | | `image_urls` | array | yes | — | **1–20** publicly-fetchable HTTPS URLs. | | `number_of_images` | int | no | 1 | 1–4 outputs per call. | | `aspect_ratio` | enum | no | `auto` | `auto` follows input; lock for batch consistency. | | `resolution` | enum | no | `1K` | `0.5K` / `1K` / `2K` / `4K`. | | `output_format` | enum | no | `png` | `png` / `jpeg` / `webp`. | | `seed` | int | no | — | Reproducibility. | | `enable_web_search` | bool | no | false | Web-grounded edits (extra latency). |

### Invoke

```bash runcomfy run google/nano-banana-2/edit \ --input '{ "prompt": "Keep the subject identity, pose, and clothing unchanged. Convert the background into a rainy neon cyberpunk street.", "image_urls": ["https://.../portrait.jpg"] }' \ --output-dir <absolute/path> ```

**Batch (lock aspect + resolution):**

```bash runcomfy run google/nano-banana-2/edit \ --input '{ "prompt": "Replace the watermark in the bottom-right with the text \"AURA\" in clean white sans-serif. Keep everything else exactly as in the input.", "image_urls": ["https://.../sku-1.jpg", "https://.../sku-2.jpg", "https://.../sku-3.jpg"], "aspect_ratio": "1:1", "resolution": "1K" }' \ --output-dir <absolute/path> ```

### Prompting tips

- **Preservation first**: `"Keep [identity / pose / brand / framing] unchanged."` Then state the change. - **Spatial scope**: "background only", "the left object", "upper-right quadrant" — concrete locations honored. - **Batch consistency**: lock `aspect_ratio` and `resolution` across the batch. - **Iterate small**: sp