gpt-image-2

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

---
name: gpt-image-2
displayName: "GPT Image 2 — Pro Pack on RunComfy"
description: >
  Generate and edit images with OpenAI GPT Image 2 (ChatGPT Images 2.0)
  on RunComfy. Documents GPT Image 2's strengths (embedded text, logos,
  multilingual typography, instruction precision), its 3 fixed sizes,
  edit-with-preservation language, and when to route to a sibling
  (Flux 2 / Nano Banana Pro / Seedream) instead. Calls `runcomfy run
  openai/gpt-image-2/text-to-image` or `/edit` through the local
  RunComfy CLI. Triggers on "gpt image 2", "gpt-image-2", "ChatGPT
  Images 2", "image 2", or any explicit ask to generate or edit with
  this model.
homepage: https://www.runcomfy.com
license: MIT
---

# GPT Image 2 — Pro Pack on RunComfy

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

OpenAI **GPT Image 2** (ChatGPT Images 2.0) hosted on the **RunComfy Model API** — no OpenAI key, async REST.

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

## When to pick this model (vs siblings)

GPT Image 2's distinct strength is **directive precision**: it follows multi-element prompts, layout cues, and embedded-text instructions more reliably than its peers. Pick it when **what's on the canvas matters more than how stylized it looks**.

| You want | Use |
|---|---|
| Embedded text, logos, signage, multilingual typography | **GPT Image 2** |
| Brand-safe, e-commerce / ad / UI mockup imagery | **GPT Image 2** |
| Iterative refinement that holds composition stable | **GPT Image 2** |
| Heavy stylization, painterly look | Flux 2 |
| Hyperrealistic portrait | Nano Banana Pro |
| Cinematic / aesthetic-first hero shots | Seedream 5 |

If the user explicitly asked for GPT Image 2 / ChatGPT Image 2 / Image 2, route here regardless — don't second-guess the model choice.

## 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

Two endpoints, same model.

### `openai/gpt-image-2/text-to-image`

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `prompt` | string | yes | — | The positive prompt |
| `size` | enum | no | `1024_1024` | `1024_1024` (1:1), `1024_1536` (2:3 portrait), `1536_1024` (3:2 landscape) — **only these three** |

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

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `prompt` | string | yes | — | Natural-language **edit instruction** |
| `images` | string[] | yes | — | **Up to 10** reference image URLs (publicly fetchable HTTPS) |
| `size` | enum | no | `auto` | `auto` (preserve input ratio), or one of the three fixed sizes above |

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

## How to invoke

**Text-to-image:**

```bash
runcomfy run openai/gpt-image-2/text-to-image \
  --input '{"prompt": "<user prompt>", "size": "1024_1536"}' \
  --output-dir <absolute/path>
```

**Edit (single ref):**

```bash
runcomfy run openai/gpt-image-2/edit \
  --input '{
    "prompt": "<edit instruction>",
    "images": ["https://..."]
  }' \
  --output-dir <absolute/path>
```

**Edit (multi-ref, up to 10):**

```bash
runcomfy run openai/gpt-image-2/edit \
  --input '{
    "prompt": "compose subject from image 1 into the room from image 2; match the lighting of image 2",
    "images": ["https://...subject.jpg", "https://...room.jpg"]
  }' \
  --output-dir <absolute/path>
```

The CLI su