Skip to main content
skill CX Codex

gpt-image-2 · acedatacloud — Claude Code skill: what it does, how to install

Generates and composites graphics using OpenAI gpt-image-2 through the AceDataCloud API. Blends existing logos, screenshots, and QR codes into scenes while keeping exact shapes.

Apache-2.0 219 installs ★ 17 updated 2026-11-07

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a claude-code
Open on GitHub

What gpt-image-2 does

The skill talks to two synchronous AceDataCloud endpoints: direct generation (/openai/images/generations) and multipart editing (/openai/images/edits). The editing workflow accepts several local paths or URLs via image[]. That setup lets you insert real brand elements or screenshots into backgrounds without redrawing marks or degrading letter clarity.

Output sizing supports ratio presets like 1792x1024, 1024x1024, and 4K variations (3840x2160), alongside an auto mode. Custom dimensions must have side lengths divisible by 16, remain under 3840 pixels, stay between 655,360 and 8,294,400 total pixels, and keep aspect ratios within 3:1.

An ACEDATACLOUD_API_TOKEN entry in your project .env file is mandatory. Base pricing for gpt-image-2 is 0.19 credits per successful output image, meaning requesting n: 4 bills quadruple the amount of a single return.

What it helps with

  • blend real product logos or QR codes into backdrops without color shifts
  • preserve character traits across sequential video beat illustrations
  • generate marketing visuals containing crisp and readable text labels
  • restyle raw application screenshots into branded graphic assets

Example prompts for the agent

  • Generate a 1792x1024 dark tech hero illustration with subtle glowing hubs
  • Place @logo.png cleanly on @background.png, maintaining original colors and geometry
  • Restyle @app-screen.png into an isometric render while keeping interface text legible

How to install gpt-image-2

1Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill gpt-image-2 -a claude-code

2Manually: put the files in place

~/.claude/skills/gpt-image-2/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gpt-image-2/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about gpt-image-2

How to install gpt-image-2 in Claude Code?

Run npx skills add AceDataCloud/Skills --skill gpt-image-2 -a claude-code. The definition is placed in ~/.claude/skills/gpt-image-2/SKILL.md.

What credentials does gpt-image-2 require?

You must define ACEDATACLOUD_API_TOKEN inside your local .env file before making requests.

How does billing work for multi-image requests?

Standard gpt-image-2 charges 0.19 credits per successful image returned. Setting n higher multiplies billing directly by the count of received images.

Source text

SKILL.md · Apache-2.0
---
name: gpt-image-2
description: Generate and EDIT images with OpenAI gpt-image-2 via AceDataCloud API. Use when you need high-fidelity images from a prompt, or to edit/composite existing images (e.g. fuse a real logo/QR/screenshot into a scene, keep characters consistent, restyle). Strong at legible text and faithful editing.
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
compatibility: Requires ACEDATACLOUD_API_TOKEN in .env file (see _shared/authentication.md).
---

# gpt-image-2 — Image Generation & Editing

OpenAI `gpt-image-2` through AceDataCloud. Two endpoints, both **synchronous** (return image url(s) directly). Its standout is **editing**: feed real images (logos, QR codes, product shots, screenshots) and it composites/restyles them faithfully — great for on-brand video assets and character consistency.

> **Setup:** See [authentication](../_shared/authentication.md) for token setup.

## 1. Generate (text → image)

```bash
curl -X POST https://api.acedata.cloud/openai/images/generations \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"a clean dark tech hero background with a glowing API hub, lots of negative space","size":"1792x1024","n":1}'
```

## 2. Edit / composite (images + prompt → image)  ← the powerful one

Multipart. Pass one or more source images via repeated `image[]` (local files with
`@`, or URLs). Use it to **fuse a real logo/QR into a generated scene**, keep a subject
consistent across scenes, or restyle a screenshot.

```bash
curl -X POST https://api.acedata.cloud/openai/images/edits \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -F "model=gpt-image-2" \
  -F "prompt=Place this logo crisply in the top-left on the tech background; keep the logo's exact colors and shape." \
  -F "image[][email protected]" \
  -F "image[][email protected]" \
  -F "size=1792x1024" \
  -F "n=1"
```

Response (both endpoints): `{"data":[{"url":"https://...png"}]}` → download `data[0].url`.

## Sizes

`size` is `WxH` (a preset) or `"auto"`. Common presets:

| Aspect | Sizes |
|---|---|
| 16:9 | `1792x1024` (HD), `2048x1152`, `3840x2160` (4K) |
| 9:16 | `1024x1792`, `1152x2048`, `2160x3840` |
| 1:1 | `1024x1024`, `2048x2048`, `2880x2880` (4K) |

(Omit `size` or use `"auto"` to let the model pick. Custom sizes must have both sides a
multiple of 16, each side ≤ 3840, total pixels between 655,360 and 8,294,400, and an aspect
ratio ≤ 3:1 — otherwise 400.)

## Model selection and billing

`gpt-image-2` and its explicit `gpt-image-2:reverse` alias bill per successful image, with a base price of 0.19 Credits per image for generation and editing. Check current account pricing and final usage records before reporting cost; returned token statistics do not change this billing mode. `gpt-image-2:official` instead bills actual token usage.

During automatic recovery, reverse models may be fulfilled using GPT Image 2.5 Flare; the requested model and per-successful-image billing remain unchanged. Do not resubmit to force recovery or silently change the user's requested model. For the Flare/Sunburst model IDs and their explicit reverse aliases, use the [GPT Image 2.5 skill](../gpt-image-2-5/SKILL.md).

## Tips

- **Editing keeps things faithful** — to place a logo/QR exactly, pass it as one of the
  `image[]` and say "keep its exact colors/shape, do not redraw it".
- For **character/scene consistency** across video beats, generate one hero image, then
  `edits` it per beat instead of regenerating from scratch.
- Text in images renders legibly — good for titles/labels you don't want to overlay in HTML.
- `n` accepts **1–10** and you are billed **per image returned**, not per request — `n: 4`
  costs 4×. (`response_format: "b64_json"` still requires `n: 1`.)
- Both endpoints are synchronous by default. For long 4K jobs pass `callback_url` (optionally
  with `async: true`) and poll `POST /openai/tasks` with `{"id": "<task_id>"}`.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Similar skills

All skills for Design →

gpt-image-2 by other authors comes first.

gpt-image-2 prime-skills Generates and edits images via OpenAI GPT Image 2 on RunComfy. Embeds text, logos, and multilingual typography accurately — for e-commerce, ads, and UI mockups. CX Codex +1 95,100installs gpt-image-2 pilioai A skill for Claude Code, Cursor, Codex and other platforms. The agent generates images from text or edits them with references through the Pilio GPT Image 2 API. CX Codex +1 20,400installs gpt-image-2 glebis Guides image generation through OpenAI's GPT Image 2 API using structured style presets, cost-saving drafts, and automated prompt validation. CX Codex +1 213installs gpt-image-skill feiskyer Generate or edit images through the OpenAI GPT Image API. The skill is for requests that name OpenAI or GPT, not for diagrams. CX Codex +1 156installs gpt-image-v2 eachlabs gpt-image-v2 is a Claude Code skill for creating and editing images through EachLabs with GPT Image v2 models. CX Codex +1 169installs gpt-image-edit prime-skills gpt-image-edit edits images through GPT Image 2 (/edit endpoint of ChatGPT Images 2.0) on RunComfy. Preserves faces and objects, rewrites text in any script (Cyrillic, CJK, Arabic), accepts up to 10 reference images. CX Codex +1 447,000installs gpt-image 101-skills Connects OpenAI GPT-Image-2 to your AI coding agent. Text-to-image, reference-based editing, mask inpainting via inference.sh CLI. CX Codex +1 14,600installs gpt-image-1-5 intellectronica Generates and edits images using OpenAI's GPT Image 1.5 model. It handles text prompts, full image alterations, and precise inpainting with masks. CX Codex +1 625installs gpt-image-2-skill reason-machines A skill and CLI for creating and editing images with OpenAI gpt-image-2. Use it for reference-based edits, masks, and batches of variants. CX Codex +1 325installs

From the same set67

The whole set →
tencentcloud-cls Search and analyze Tencent Cloud CLS logs, inspect API failures, follow trace IDs, and run CQL or SQL queries over log topics. CX Codex +1 221installs youtube Search YouTube, inspect your channel and video stats, read comments, or upload a video through the YouTube Data API v3. CX Codex +1 221installs google-drive Interacts with selected Google Drive files via Drive v3 REST API, exports Docs to Markdown, and uploads data. CX Codex +1 219installs microsoft-onedrive microsoft-onedrive is a Claude Code skill for listing, searching, downloading, and uploading OneDrive and SharePoint files through Microsoft Graph. CX Codex +1 219installs tencentcloud-dns tencentcloud-dns edits DNSPod records through the Tencent Cloud API: creates A, AAAA, CNAME, MX and TXT entries, finds them, deletes the stale ones. Handy when DNS work belongs in the terminal or an agent chat. CX Codex +1 218installs github Controls GitHub issues, pull requests, releases, and code search using the gh CLI. Useful whenever an agent needs to review a PR or update issues directly. CX Codex +1 218installs tencentcloud-tke tencentcloud-tke manages Tencent Kubernetes Engine clusters and workloads using the Python SDK alongside kubectl. Useful for rollout restarts and node pool audits. CX Codex +1 217installs tencentcloud-edgeone Manage Tencent Cloud EdgeOne zones, CDN cache, DNS records, and WAF settings from a coding agent. Use it for post-deploy cache work or configuration checks. CX Codex +1 217installs

Project sponsors

Companies that keep this analytics open