gpt-image-2

gpt-image-2 is a reusable AI skill focused on a specific workflow. description: Full OpenAI-compatible GPT Image 2 coverage across images/generations, images/edits, and responses with the image_generation tool. Use when the one-shot image helper is not enough - text-to-image, mask edits, multi-image batches, streaming, partial_images, and mixed text+image Responses flows. Reads .env and respects process environment variables; works with any OpenAI-compatible gateway.

The skill packages instructions, conventions, and task-specific guidance so an agent can execute the job more consistently. A single Python entrypoint that covers every GPT Image 2 route, with strict pre-flight validation of the model's size, aspect, and feature constraints. 1. Open [references/config.md](./references/config.md) to pick environment variables and defaults. 2. Open [references/api-surface.md](./references/api-surface.md) to choose between `generations`, `edits`, and `responses`.

In practice, this skill is best suited for users who need repeatable execution with fewer setup steps and less ambiguity. 3. Prefer `OPENAI_BASE_URL=https://api.openai.com/v1` unless the user asks for a different OpenAI-compatible endpoint. 4. Use `gpt-image-2` for `generations` and `edits`; use a text-capable Responses model such as `gpt-5.4` for `responses`. 5. Run `scripts/gpt_image.py` with one of the three subcommands. 6. Add `--dry-run` first when the payload shape is the main risk.