GPT-Image Legacy Versions

Overview of legacy GPT-Image-1 / 1-mini / 1.5 models — model IDs, pricing, endpoints, and migration tips for moving to GPT-Image-2 / GPT-Image-2-All.

For new projects, use GPT-Image-2 (official) or GPT-Image-2-All (reverse channel, flat $0.03/image). This page keeps the essentials of the legacy versions so existing integrations can troubleshoot and migrate smoothly.

Legacy Lineup

Model ID	Released	Endpoint	Pricing	Status
gpt-image-1.5	Dec 2025	/v1/images/generations	Input $5.00 / Output $10.00 per M tokens	Available; upgrade to gpt-image-2 recommended
gpt-image-1	Apr 2025	/v1/images/generations, /v1/images/edits	Input $2.50 / Output $8.00 per M tokens	Available; upgrade to gpt-image-2 recommended
gpt-image-1-mini	Apr 2025	/v1/images/generations	Lower than gpt-image-1	Available

Drop-in migration: change model to gpt-image-2 or gpt-image-2-all. Parameters (size / quality / output_format, …) are largely compatible — no structural code changes required.

Common Parameters (Generation)

All legacy versions share the same generation parameters:

Parameter	Description
model	gpt-image-1.5 / gpt-image-1 / gpt-image-1-mini
prompt	Image description (up to 1000 chars)
size	1024x1024 / 1536x1024 / 1024x1536 / auto
quality	low / medium / high / auto
output_format	png (default) / jpeg / webp
output_compression	JPEG/WebP only, 0–100%
background	transparent / opaque / auto
n	Number of images (1–10)

Quick Example

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"
)

response = client.images.generate(
    model="gpt-image-1.5",  {/* or gpt-image-1 / gpt-image-1-mini */}
    prompt="A professional product photo on white background, soft studio lighting",
    size="1024x1024",
    quality="high"
)

print(response.data[0].url)

Per-Image Pricing Reference

GPT-Image-1 / 1.5 support both token billing and per-image billing — the system automatically picks whichever is cheaper:

GPT-Image-1.5

Quality	1024×1024	1024×1536 / 1536×1024
Low	$0.009	$0.013
Medium	$0.034	$0.050
High	$0.133	$0.200

GPT-Image-1

Quality	1024×1024	1024×1536 / 1536×1024
Low	$0.005	$0.006
Medium	$0.011	$0.015
High	$0.036	$0.052

Per-image figures are reference only. Actual charges follow whichever billing mode (token or per-image) the system determines is cheaper.

Image Editing (gpt-image-1 only)

gpt-image-1 supports mask-based editing via the /v1/images/edits endpoint:

response = client.images.edit(
    model="gpt-image-1",
    image=open("original.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="A modern glass skyscraper with reflective windows",
    size="1024x1024"
)

Parameter	Description
image	Source image, PNG/WebP/JPG, < 50MB each, up to 16 images
mask	Mask image — pixels with alpha=0 will be repainted
prompt	Description of what to generate in the masked region

For new editing workflows, use GPT-Image-2 Edit (official) or GPT-Image-2-All Edit (reverse, supports up to 16 input images for blending).

Migrating to GPT-Image-2 / 2-All

Your need	Recommended target
Stay on official OpenAI endpoint, need precise size/quality control	gpt-image-2 (official)
Want predictable flat pricing ($0.03/image), better instruction following	gpt-image-2-all (reverse)
Still need mask-based image editing	gpt-image-2-all edit endpoint (up to 16 images)

GPT-Image-2 Overview

Latest official version — endpoint and parameters compatible with legacy

GPT-Image-2-All Overview

Reverse channel, flat $0.03/image, faster turnaround

Official vs Reverse Comparison

Side-by-side comparison and selection guide