mcpField
G
gpt-image

gpt-image

github.com/halt-catch-fireCreative & media11.6k installsUpdated 12w ago
Repository

About gpt-image

gpt-image is a skill for running OpenAI's GPT-Image-2 through the inference.sh belt CLI. It covers image generation and editing, including masked inpainting and batch output.

Key features

  1. 01Text-to-image generation
  2. 02Reference-image editing
  3. 03Mask-based inpainting
  4. 04Generate up to 10 images
  5. 05PNG, JPEG, and WebP output
  6. 06Adjustable output dimensions

Use cases

  1. 01Create images from text prompts
  2. 02Edit images using one or more references
  3. 03Replace selected regions with a mask

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/halt-catch-fire/superpowers --skill gpt-image

After installing, type/gpt-imagein Claude Code to confirm it loaded.

Details

From the project README

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.

FeatureDescription
Text-to-ImageGenerate images from text prompts
Image EditingEdit images using reference images
InpaintingMask-based editing of specific regions
Batch GenerationGenerate up to 10 images at once
Multiple FormatsPNG, JPEG, WebP output
Flexible ResolutionAny 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

ParameterTypeDefaultDescription
promptstringrequiredText prompt describing the image
imagesarray-Reference image(s) for editing
maskstring-Mask image for inpainting
ninteger1Number of images (1–10)
qualitystring-low, medium, or high
widthinteger-Output width (256–4096, multiples of 32)
heightinteger-Output height (256–4096, multiples of 32)
output_formatstringpngpng, jpeg, or webp
output_compressioninteger-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-image

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

Documentation

Comments

Markdown supported