gpt-image-2 · acedatacloud — скилл для Claude Code: что делает и как установить
Генерирует и редактирует изображения через AceDataCloud API модели OpenAI gpt-image-2. Встраивает реальные логотипы, скриншоты и QR-коды прямо в сцены с сохранением исходных форм.
Apache-2.0 219 установок ★ 17 обновлён 2026-11-07
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a claude-codeЧто делает gpt-image-2
Скилл обращается к двум синхронным эндпоинтам AceDataCloud: генерация по тексту (/openai/images/generations) и редактирование или композитинг (/openai/images/edits). В режиме редактирования можно передать несколько исходных файлов через image[] (локальные пути или ссылки). Модель сохраняет фирменные цвета, не перерисовывает векторные контуры и поддерживает разборчивый текст на итоговой картинке.
Разрешение задаётся готовыми пресетами от 1024x1024 до 4K (3840x2160), значением auto или произвольными размерами. Для нестандартных габаритов обе стороны должны делиться на 16, быть не больше 3840 пикселей, а соотношение сторон не может превышать 3:1.
Для вызовов обязателен токен ACEDATACLOUD_API_TOKEN в файле .env. Базовая модель gpt-image-2 списывает 0.19 кредита за каждую успешно сгенерированную картинку, поэтому параметр n: 4 обойдётся ровно в четыре раза дороже одного кадра.
Какие задачи решает
- встроить логотип или QR-код в сгенерированный баннер без искажения пропорций
- сохранить внешность персонажа на разных раскадровках через эндпоинт редактирования
- получить фоновые иллюстрации и промо-графику с читаемыми текстовыми надписями
- стилизовать скриншот интерфейса под нужную цветовую палитру
Примеры запросов агенту
- Сгенерируй баннер 1792x1024 в тёмных тонах с неоновым серверным узлом
- Встрой логотип из
@logo.pngв верхний левый угол@background.png, сохрани точные цвета и форму - Отредактируй сцену с персонажем из
@hero.png, переместив его в интерьер лаборатории
Как установить gpt-image-2
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a claude-code2Вручную: положить файлы
~/.claude/skills/gpt-image-2/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gpt-image-2/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a codex2Вручную: положить файлы
.agents/skills/gpt-image-2/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a cursor2Вручную: положить файлы
.cursor/skills/gpt-image-2/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/gpt-image-22Вручную: положить файлы
.github/skills/gpt-image-2/SKILL.md1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a gemini-cli2Командой платформы
gemini skills install https://github.com/AceDataCloud/Skills --path skills/gpt-image-2Вручную: положить файлы
.devin/skills/gpt-image-2/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill gpt-image-2 -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gpt-image-2
Как установить gpt-image-2 в Claude Code?
Выполните команду npx skills add AceDataCloud/Skills --skill gpt-image-2 -a claude-code. Файл конфигурации сохранится по пути ~/.claude/skills/gpt-image-2/SKILL.md.
Что нужно для работы скилла?
Требуется действующий ключ ACEDATACLOUD_API_TOKEN в вашем .env. Без него API вернёт ошибку авторизации.
Как списывается оплата за запросы?
Модели gpt-image-2 и псевдоним gpt-image-2:reverse тарифицируются по 0.19 кредита за каждое полученное изображение. Если запросить n=2, спишется двойная стоимость.
Исходный текст
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
Похожие скиллы
Все скиллы по теме «Дизайн» →Сначала — gpt-image-2 от других авторов.