gpt-image-edit

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: gpt-image-edit
displayName: "GPT Image Edit — Pro Pack on RunComfy"
description: >
  Edit images with OpenAI GPT Image 2 (the `/edit` endpoint of ChatGPT
  Images 2.0) on RunComfy — bundled with the model's documented
  prompting patterns so the skill gets sharper output than naive
  prompting against the same model. Documents GPT Image Edit's strengths
  (preservation language, multilingual in-image text editing,
  multi-reference up to 10 images, layout / typography precision),
  the schema, and when to route to Nano Banana Edit / Flux Kontext /
  GPT Image 2 t2i instead. Calls
  `runcomfy run openai/gpt-image-2/edit` through the local RunComfy CLI.
  Triggers on "gpt image edit", "gpt-image-edit", "chatgpt image edit",
  "edit with gpt image 2", or any explicit ask to edit with this model.
homepage: https://www.runcomfy.com
license: MIT
---

# GPT Image Edit — Pro Pack on RunComfy

[runcomfy.com](https://www.runcomfy.com/?utm_source=skills.sh&utm_medium=skill&utm_campaign=gpt-image-edit) · [Edit endpoint](https://www.runcomfy.com/models/openai/gpt-image-2/edit?utm_source=skills.sh&utm_medium=skill&utm_campaign=gpt-image-edit) · [Text-to-image sibling](https://www.runcomfy.com/models/openai/gpt-image-2/text-to-image?utm_source=skills.sh&utm_medium=skill&utm_campaign=gpt-image-edit) · [GitHub](https://github.com/agentspace-so/runcomfy-skills/tree/main/gpt-image-edit)

OpenAI **GPT Image 2 — `/edit` endpoint** (ChatGPT Images 2.0 image-to-image) on the **RunComfy Model API**. Strongest in its class at preserving identity through targeted edits and rewriting embedded text in any script (Latin, kana, CJK, Cyrillic, Arabic).

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

## When to pick this model (vs siblings)

| You want | Use |
|---|---|
| Edit multilingual / embedded text in image | **GPT Image Edit** |
| Identity preservation through translated headline variants | **GPT Image Edit** |
| Layout-precise edit (move headline, swap CTA, etc.) | **GPT Image Edit** |
| Up to 10 reference images | **GPT Image Edit** |
| Batch up to 20 images consistently | Nano Banana Edit |
| Single-shot precise local edit, source-fidelity-first | Flux Kontext |
| Generate from scratch with GPT Image 2 | sibling [`gpt-image-2`](../gpt-image-2) skill |
| Batch SKU galleries with stable identity | Nano Banana Edit |

## Prerequisites

1. **RunComfy CLI** — `npm i -g @runcomfy/cli`
2. **RunComfy account** — `runcomfy login` opens a browser device-code flow.
3. **CI / containers** — set `RUNCOMFY_TOKEN=<token>` instead of `runcomfy login`.

## Endpoints + input schema

### `openai/gpt-image-2/edit`

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `prompt` | string | yes | — | Edit instruction. Lead with preservation, end with the change. |
| `images` | string[] | yes | — | **Up to 10** publicly-fetchable HTTPS URLs. First is primary; rest are auxiliary. |
| `size` | enum | no | `auto` | `auto` (preserve input), `1024_1024` (1:1), `1024_1536` (2:3 portrait), `1536_1024` (3:2 landscape). |

`size=auto` preserves the input ratio — strongly recommended unless the edit explicitly changes framing.

## How to invoke

**Single-ref preservation edit:**

```bash
runcomfy run openai/gpt-image-2/edit \
  --input '{
    "prompt": "Keep the person'\''s face, pose, and brand mark unchanged. Replace the background with a soft warm-grey studio sweep and a gentle floor shadow.",
    "images": ["https://.../portrait.jpg"]
  }' \
  --output-dir <absolute/path>
```

**Multilingual text rewrite (preserve everything except the headline):**

```bash
runcomfy run openai/gpt-image-2/edit \
  --input '{
    "prompt": "Keep the photograph, layout, and brand mark exactly as in the input. Replace only the in-image headline. The new headline reads \"今日のおすすめ\" in bold Japanese kana, same position and font weight as before.",
    "images": ["https://.../poster-en.jpg"]
  }' \
  --output-dir <absolute/path>
```

**Mu