back
loading skill details...
GPT Image 2 on RunComfy. GPT Image 2 (OpenAI ChatGPT Images 2.0) is the strongest text-rendering image model available β embedded text, logos, signage, multi...
---
name: gpt-image-2-runcomfy
displayName: "𫧠GPT Image 2 β Pro Pack on RunComfy"
description: >
GPT Image 2 on RunComfy. GPT Image 2 (OpenAI ChatGPT Images 2.0) is
the strongest text-rendering image model available β embedded text,
logos, signage, multilingual typography, and high-fidelity layout.
This skill calls GPT Image 2 through the RunComfy CLI: `runcomfy run
openai/gpt-image-2/text-to-image` (or `/edit`). GPT Image 2 has 3
fixed sizes and supports up to 10 reference images on the GPT Image 2
edit endpoint. Triggers on "gpt image 2", "gpt-image-2", "ChatGPT
Images 2", "ChatGPT Image 2", "OpenAI Image 2", "GPT Image", or any
explicit ask to generate or edit with GPT Image 2.
emoji: "π«§"
homepage: https://www.runcomfy.com
license: MIT
clawdis:
requires:
bins:
- runcomfy
env:
- RUNCOMFY_TOKEN
config:
- ~/.config/runcomfy
---
# 𫧠GPT Image 2 β Pro Pack on RunComfy
[runcomfy.com](https://www.runcomfy.com/?utm_source=clawhub&utm_medium=skill&utm_campaign=gpt-image-2-runcomfy) Β· [GPT Image 2 text-to-image](https://www.runcomfy.com/models/openai/gpt-image-2/text-to-image?utm_source=clawhub&utm_medium=skill&utm_campaign=gpt-image-2-runcomfy) Β· [GPT Image 2 edit](https://www.runcomfy.com/models/openai/gpt-image-2/edit?utm_source=clawhub&utm_medium=skill&utm_campaign=gpt-image-2-runcomfy) Β· [docs](https://docs.runcomfy.com/cli/introduction?utm_source=clawhub&utm_medium=skill&utm_campaign=gpt-image-2-runcomfy)
**GPT Image 2** is OpenAI's ChatGPT Images 2.0 model. This skill generates and edits images with GPT Image 2 hosted on the RunComfy Model API β `runcomfy run openai/gpt-image-2/<endpoint>` from your terminal, no OpenAI API key required.
## What GPT Image 2 is
GPT Image 2 (also called ChatGPT Image 2 or just Image 2) is the second-generation OpenAI image model behind ChatGPT's Image feature, exposed here as a standalone API. Three properties make GPT Image 2 distinct:
- **GPT Image 2 directive precision.** GPT Image 2 follows multi-element prompts, layout cues, and embedded-text instructions more reliably than peers in 2026. When you tell GPT Image 2 to render a specific headline at a specific position, GPT Image 2 does it. This makes GPT Image 2 the right model when **what's on the canvas matters more than how stylized it looks**.
- **GPT Image 2 in-image typography.** GPT Image 2 is the strongest text-rendering image model in the catalog. GPT Image 2 reproduces quoted characters at high fidelity β short headlines, brand marks, multilingual signage (Latin, Cyrillic, Japanese kana, Arabic, etc.). When GPT Image 2 sees `"AURA"` in the prompt, GPT Image 2 renders the literal word.
- **GPT Image 2 composition stability across iterations.** GPT Image 2 holds layout stable when you change one descriptor and keep the rest of the prompt verbatim. This makes GPT Image 2 ideal for refining a single brand asset across rounds without redrafting from zero.
GPT Image 2 has two endpoints in this skill:
- **GPT Image 2 text-to-image** β generate a fresh image from a prompt.
- **GPT Image 2 edit** β modify a reference image (or compose from up to 10 references), with natural-language preservation language ("keep face identity unchanged", "keep the brand mark").
## When GPT Image 2 is the right choice
Pick GPT Image 2 when any of these is true:
- The image needs **embedded text** β labels, signage, headlines, multilingual typography. GPT Image 2 is the strongest option.
- You're producing **brand-safe e-commerce / ad / UI mockup imagery**. GPT Image 2 directive precision shines here.
- You're doing **iterative refinement on a single image** β change one knob, keep composition stable. GPT Image 2 holds layout across rounds.
- You're producing **brand-asset localization** β same source asset, many language variants of the same headline. GPT Image 2 multilingual text rendering makes this fast.
- The user explicitly asked for **GPT Image 2** / **ChatGPT Image 2** / **Image 2** / **OpenAI Image 2** β route to this GPT Image 2 skill regardless.
## 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
GPT Image 2 has two endpoints, same model.
### `openai/gpt-image-2/text-to-image`
The GPT Image 2 generation endpoint.
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `prompt` | string | yes | β | Positive prompt for GPT Image 2. |
| `size` | enum | no | `1024_1024` | GPT Image 2 supports only three sizes: `1024_1024` (1:1), `1024_1536` (2:3 portrait), `1536_1024` (3:2 landscape). |
### `openai/gpt-image-2/edit`
The GPT Image 2 edit endpoint.
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `prompt` | string | yes | β | Natural-language edit instruction for GPT Image 2. |
| `images` | string[] | yes | β | Up to **10 reference images** for GPT Image 2 edit (publicly fetchable HTTPS URLs). |
| `size` | enum | no | `auto` | `auto` (preserve input ratio) or one of the three GPT Image 2 fixed sizes. |
`size=auto` on GPT Image 2 edit preserves input aspect ratio β strongly recommended unless you explicitly want GPT Image 2 to reframe.
## How to invoke GPT Image 2
**GPT Image 2 text-to-image:**
```bash
runcomfy run openai/gpt-image-2/text-to-image \
--input '{"prompt": "<GPT Image 2 prompt>", "size": "1024_1536"}' \
--output-dir <absolute/path>
```
**GPT Image 2 edit (single reference):**
```bash
runcomfy run openai/gpt-image-2/edit \
--input '{
"prompt": "<GPT Image 2 edit instruction>",
"images": ["https://..."]
}' \
--output-dir <absolute/path>
```
**GPT Image 2 edit (multi-reference, 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 submits the GPT Image 2 request, polls every 2s, fetches the GPT Image 2 result, and downloads any `*.runcomfy.net` / `*.runcomfy.com` URL into `--output-dir`.
For pipe-friendly GPT Image 2 usage:
```bash
runcomfy --output json run openai/gpt-image-2/text-to-image \
--input '{"prompt":"..."}' --no-wait | jq -r .request_id
```
## Prompting GPT Image 2 β what works
GPT Image 2 responds to specific prompting patterns better than naive prose. Apply these for sharper GPT Image 2 output. Same patterns work on both GPT Image 2 text-to-image and GPT Image 2 edit.
**Be explicit with subject + setting + mood for GPT Image 2.** "A close-up of a matte ceramic water bottle on warm linen, soft window light, neutral background" β three concrete directives β beats "nice product photo of a bottle". GPT Image 2 reads concrete directives well.
**Quote embedded text exactly for GPT Image 2.** GPT Image 2 is the strongest text-rendering model in this class β but only when you put the literal characters in quotes. Long blocks of text degrade GPT Image 2 output. For multilingual typography, name the script: "Japanese kana", "Cyrillic", "Arabic right-to-left". GPT Image 2 will render accordingly.
**Use compositional cues directly.** "rule of thirds", "close-up", "aerial view", "centered subject", "shallow depth of field" β GPT Image 2 understands these as real directives.
**Iterate one attribute at a time on GPT Image 2.** When refining, change one thing per iteration (lighting OR background OR pose OR text) and keep the rest of the GPT Image 2 prompt verbatim. GPT Image 2 holds composition stable across iterations when only one knob moves.
**Don't conflict GPT Image 2 instructions.** "no text" + "the word 'AQUA+' on the label" is incoherent β GPT Image 2 will pick one and you don't control which.
**Don't pile up styles in a GPT Image 2 prompt.** "ukiyo-e + watercolor + 8K + cinematic + minimalist" cancels out in GPT Image 2 output. Pick one or two style anchors max.
For GPT Image 2 **edit** specifically:
- **State preservation goals to GPT Image 2.** "**keep** the person's pose and face identity unchanged", "**keep** the brand mark and typography on the package", "**keep** the overall framing". GPT Image 2 needs to know what NOT to change.
- **Use directional language for GPT Image 2 spatial edits.** "Move the headline from top-right to bottom-center", not "reposition the headline".
- **Multi-ref GPT Image 2**: number the images in the prompt β "subject from image 1, lighting and background from image 2" β and GPT Image 2 will route the cues correctly.
## Where GPT Image 2 shines
| Use case | Why GPT Image 2 |
|---|---|
| **E-commerce product photography** | GPT Image 2 reliable text on labels, brand-safe lighting, consistent across SKUs |
| **High-conversion ads** | GPT Image 2 headline + visual integration in one pass |
| **Brand asset localization** | One source asset β many language variants of the same headline via GPT Image 2 |
| **Signage, posters, packaging mock-ups** | GPT Image 2 text rendering accuracy at multiple scales |
| **UI mockups, scientific illustrations** | GPT Image 2 layout precision and label legibility |
## Sample GPT Image 2 prompts (verified to produce strong results)
**GPT Image 2 text-to-image β product hero:**
```
A minimal hero product still life: a matte ceramic water bottle on warm linen,
soft window light, the word "AQUA+" in clean sans-serif on the label,
subtle rim highlights, e-commerce ready, 8K detail, neutral background
```
**GPT Image 2 text-to-image β multilingual signage:**
```
A small Tokyo cafΓ© storefront at dusk, warm interior glow,
the sign reads "γ³γΌγγΌ" in bold Japanese kana on a wooden plaque,
shallow depth of field, rule of thirds, cinematic
```
**GPT Image 2 edit β background swap with preservation:**
```
Turn the background into a bright minimal white-to-soft-gray studio sweep
with gentle floor shadow; add a large headline in-image that reads
"OPEN STUDIO" in a bold clean sans-serif, high contrast, centered;
keep the main person or product, pose, and face identity unchanged
```
## GPT Image 2 FAQ
**What sizes does GPT Image 2 support?** Only three: `1024_1024` (1:1), `1024_1536` (2:3 portrait), `1536_1024` (3:2 landscape). Extreme aspect ratios are auto-resized to the nearest supported GPT Image 2 size.
**How many reference images can GPT Image 2 edit take?** Up to 10. The first image is the primary reference for GPT Image 2; the rest provide auxiliary cues (lighting, background, style).
**Can GPT Image 2 render text in any language?** GPT Image 2 handles Latin, Cyrillic, Japanese kana, Korean Hangul, Arabic, Chinese, and most major scripts. Name the script in the GPT Image 2 prompt for best fidelity.
**Is GPT Image 2 the same as DALL-E?** No. GPT Image 2 is the successor model behind ChatGPT's Image feature; DALL-E was the predecessor line. GPT Image 2 has stronger directive precision and stronger in-image typography than the DALL-E generation.
**How does GPT Image 2 compare to GPT Image (v1)?** GPT Image 2 is the second-generation model. GPT Image 2 has higher fidelity, stronger text rendering, and better composition stability than GPT Image v1.
**Does GPT Image 2 generate at very high resolution?** GPT Image 2 outputs at the three documented sizes only. For higher-resolution upscaling, post-process the GPT Image 2 output through a separate upscaler.
**How do I reproduce a GPT Image 2 output?** GPT Image 2 doesn't expose a `seed` parameter on this endpoint. For reproducible variants, lock the prompt and re-run.
## Limitations of GPT Image 2
- **GPT Image 2 has only 3 fixed sizes** on text-to-image (and the same 3 + `auto` on GPT Image 2 edit).
- **GPT Image 2 prompt length** caps at a few thousand tokens. Long blocks of embedded text degrade GPT Image 2 output.
- **GPT Image 2 edit multi-image** support is "guidance from up to 10 refs", not ControlNet-style stacks.
- **Photorealism on portraits** is not GPT Image 2's strongest suit β for hyperrealistic portraits, route to a different model.
## Exit codes
The `runcomfy` CLI uses sysexits-style codes:
| code | meaning |
|---|---|
| 0 | GPT Image 2 generation succeeded |
| 64 | bad CLI args |
| 65 | bad input JSON for GPT Image 2 / schema mismatch (e.g. `size: "2048_2048"` would 422) |
| 69 | upstream 5xx |
| 75 | retryable: timeout / 429 |
| 77 | not signed in or token rejected |
Full reference: [docs.runcomfy.com/cli/troubleshooting](https://docs.runcomfy.com/cli/troubleshooting?utm_source=clawhub&utm_medium=skill&utm_campaign=gpt-image-2-runcomfy).
## How it works
1. The skill invokes `runcomfy run openai/gpt-image-2/<endpoint>` with a JSON body matching the GPT Image 2 schema.
2. The CLI POSTs to `https://model-api.runcomfy.net/v1/models/openai/gpt-image-2/<endpoint>` with the user's bearer token.
3. The Model API returns a `request_id`; the CLI polls `GET .../requests/<id>/status` every 2 seconds.
4. On terminal status, the CLI fetches the GPT Image 2 result and downloads any `.runcomfy.net` / `.runcomfy.com` URL into `--output-dir`.
5. `Ctrl-C` while polling cancels the GPT Image 2 request via `POST .../requests/<id>/cancel`.
## What this skill is not
Not a direct OpenAI API client. Not a capability grant β depends on a working RunComfy account.
## Security & Privacy
- **Token storage**: `runcomfy login` writes the API token to `~/.config/runcomfy/token.json` with mode 0600.
- **Input boundary**: the GPT Image 2 prompt is passed as JSON via `--input`. No shell injection.
- **Third-party content**: image URLs are fetched by the RunComfy server. Treat external URLs as untrusted.
- **Outbound endpoints**: only `model-api.runcomfy.net` and `*.runcomfy.net` / `*.runcomfy.com`.
- **Generated-file size cap**: 2 GiB.
don't have the plugin yet? install it then click "run inline in claude" again.