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
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a claude-codeWhat 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.pngcleanly on@background.png, maintaining original colors and geometry - Restyle
@app-screen.pnginto 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-code2Manually: put the files in place
~/.claude/skills/gpt-image-2/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gpt-image-2/
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a codex2Manually: put the files in place
.agents/skills/gpt-image-2/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a cursor2Manually: put the files in place
.cursor/skills/gpt-image-2/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/gpt-image-22Manually: put the files in place
.github/skills/gpt-image-2/SKILL.md1Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a gemini-cli2Platform CLI
gemini skills install https://github.com/AceDataCloud/Skills --path skills/gpt-image-2Manually: put the files in place
.devin/skills/gpt-image-2/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.