GPT-Image Skill | Agent Skills

Install the belt CLI skill: npx skills add belt-sh/cli

GPT-Image

Generate and edit images with OpenAI's GPT-Image-2.5 and GPT-Image-2 via inference.sh CLI.

Models

| Model | App ID | Pick it for | |-------|--------|-------------| | GPT-Image-2.5 Flare | openai/gpt-image-2-5-flare | Default. Higher quality than GPT-Image-2 at 50% lower latency | | GPT-Image-2.5 Sunburst | openai/gpt-image-2-5-sunburst | Premium edits: keeps subject and composition, tighter control across multi-turn edits | | GPT-Image-2 | openai/gpt-image-2 | Previous generation |

All three share the same input schema. The 2.5 models add xhigh and max quality tiers.

Quick Start

Requires inference.sh CLI (belt). Install instructions

belt login

belt app run openai/gpt-image-2-5-flare --input '{"prompt": "a cat astronaut floating in space"}'

Capabilities

Every GPT-Image app supports text-to-image generation, image editing with reference images, and mask-based inpainting through a single app.

| Feature | Description | |---------|-------------| | Text-to-Image | Generate images from text prompts | | Image Editing | Edit images using reference images | | Inpainting | Mask-based editing of specific regions | | Batch Generation | Generate up to 10 images at once | | Multiple Formats | PNG, JPEG, WebP output | | Transparent Background | Alpha-channel PNG/WebP output for stickers, icons, product cutouts | | Flexible Resolution | Any size in 16px increments (256–3840), aspect ratio up to 3:1 |

Examples

Text-to-Image

belt app run openai/gpt-image-2-5-flare --input '{
  "prompt": "professional product photo of sneakers on a white background, studio lighting",
  "quality": "high"
}'

Multiple Images

belt app run openai/gpt-image-2-5-flare --input '{
  "prompt": "minimalist logo design for a coffee shop",
  "n": 4,
  "quality": "medium"
}'

Image Editing with Reference

belt app run openai/gpt-image-2-5-flare --input '{
  "prompt": "change the background to a beach at sunset",
  "images": ["https://your-image.jpg"]
}'

Precise Edit with Sunburst

Sunburst is built to change only what you ask for and preserve the rest.

belt app run openai/gpt-image-2-5-sunburst --input '{
  "prompt": "change the jacket to red leather, keep the person, pose and background unchanged",
  "images": ["https://your-photo.jpg"],
  "quality": "high"
}'

Maximum Detail

belt app run openai/gpt-image-2-5-flare --input '{
  "prompt": "macro photo of a dragonfly wing, intricate veins, morning dew",
  "quality": "max"
}'

Multi-Image Reference

belt app run openai/gpt-image-2-5-flare --input '{
  "prompt": "combine these two characters into one scene",
  "images": ["https://character1.jpg", "https://character2.jpg"]
}'

Inpainting with Mask

belt app run openai/gpt-image-2-5-flare --input '{
  "prompt": "replace with a red sports car",
  "images": ["https://street-scene.jpg"],
  "mask": "https://car-mask.png"
}'

Transparent Background

Prompt for an isolated subject — describing a scene or backdrop makes the model draw one. Requires png (default) or webp output.

belt app run openai/gpt-image-2-5-flare --input '{
  "prompt": "a single red apple with a green leaf, isolated subject",
  "background": "transparent"
}'

Custom Resolution

belt app run openai/gpt-image-2-5-flare --input '{
  "prompt": "wide cinematic landscape, mountains at golden hour",
  "width": 1920,
  "height": 1080,
  "quality": "high"
}'

Fast Drafts

belt app run openai/gpt-image-2-5-flare --input '{
  "prompt": "quick concept sketch of a robot",
  "quality": "low"
}'

Pricing

Approximate price per 1024x1024 image. Flare and Sunburst cost the same.

| Quality | GPT-Image-2.5 | GPT-Image-2 | |---------|---------------|-------------| | low | $0.006 | $0.006 | | medium | $0.013 | $0.053 | | high | $0.053 | $0.21 | | xhigh | $0.094 | – | | max | $0.21 | – |

Larger resolutions cost more. Edits add about $0.008 per reference image. See belt app get openai/gpt-image-2-5-flare for full pricing details.

Parameters

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | prompt | string | required | Text prompt describing the image | | images | array | - | Reference image(s) for editing | | mask | string | - | Mask image for inpainting | | n | integer | 1 | Number of images (1–10) | | quality | string | auto | low, medium, high, xhigh, max (xhigh/max are 2.5 only) | | width | integer | 1024 | Output width (256–3840, multiples of 16, ratio ≤ 3:1) | | height | integer | 1024 | Output height (256–3840, multiples of 16, ratio ≤ 3:1) | | output_format | string | png | png, jpeg, or webp | | output_compression | integer | - | Compression level for jpeg/webp (0–100) | | background | string | auto | auto, transparent, or opaque (transparent needs png/webp) |

Related Skills

# Full platform skill (all apps)
npx skills add inference-sh/skills@infsh-cli

# All image generation models
npx skills add inference-sh/skills@ai-image-generation

# FLUX models
npx skills add inference-sh/skills@flux-image

# Pruna P-Image (fast & economical)
npx skills add inference-sh/skills@p-image

Browse all image apps: belt app list --category image

Documentation

Running Apps - How to run apps via CLI
Streaming Results - Real-time progress updates

Agent Skills: GPT-Image

Install this agent skill to your local

Skill Files