Imported from halt-catch-fire/mutiny (
tools/image/gpt-image/SKILL.md). Install upstream withnpx skills add halt-catch-fire/mutiny --skill gpt-image. Copyright stays with the author.
Install the belt CLI skill:
npx skills add belt-sh/cli
GPT-Image-2
Generate and edit images with OpenAI's GPT-Image-2 via inference.sh CLI.
Quick Start
Requires inference.sh CLI (
belt). Install instructions
belt login
belt app run openai/gpt-image-2 --input '{"prompt": "a cat astronaut floating in space"}'Capabilities
GPT-Image-2 supports text-to-image generation, image editing with reference images, and mask-based inpainting — all through a single model.
| 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 |
| Flexible Resolution | Any size in 32px increments (256–4096) |
Examples
Text-to-Image
belt app run openai/gpt-image-2 --input '{
"prompt": "professional product photo of sneakers on a white background, studio lighting",
"quality": "high"
}'Multiple Images
belt app run openai/gpt-image-2 --input '{
"prompt": "minimalist logo design for a coffee shop",
"n": 4,
"quality": "medium"
}'Image Editing with Reference
belt app run openai/gpt-image-2 --input '{
"prompt": "change the background to a beach at sunset",
"images": ["https://your-image.jpg"]
}'Multi-Image Reference
belt app run openai/gpt-image-2 --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 --input '{
"prompt": "replace with a red sports car",
"images": ["https://street-scene.jpg"],
"mask": "https://car-mask.png"
}'Custom Resolution
belt app run openai/gpt-image-2 --input '{
"prompt": "wide cinematic landscape, mountains at golden hour",
"width": 1920,
"height": 1080,
"quality": "high"
}'Fast Drafts
belt app run openai/gpt-image-2 --input '{
"prompt": "quick concept sketch of a robot",
"quality": "low"
}'Pricing
| Quality | ~Price per Image |
|---|---|
| Low | $0.006 |
| Medium | $0.024 |
| High | $0.21 |
Larger resolutions cost more. See belt app get openai/gpt-image-2 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 | - | low, medium, or high |
width |
integer | - | Output width (256–4096, multiples of 32) |
height |
integer | - | Output height (256–4096, multiples of 32) |
output_format |
string | png | png, jpeg, or webp |
output_compression |
integer | - | Compression level for jpeg/webp (0–100) |
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-imageBrowse all image apps: belt app list --category image
Documentation
- Running Apps - How to run apps via CLI
- Streaming Results - Real-time progress updates