Skill: kalvinrv/gpt-image-2-runcomfy (version 0.1.5)

--- 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. ### [REDACTED_SECRET] 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.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)