GPT Image API Guide: GPT-4o to GPT Image 2 + Migration

HiAPI

If you have searched for the "GPT-4o image generation API," the "gpt-image-1 API," the "GPT Image 1.5 API," or the "ChatGPT image generation API," you have been searching for the same product at four different moments in its life. OpenAI's image generation is not a menu of parallel models you choose between — it is one line that keeps replacing its own front model. This guide untangles the lineage, tells you which one to build against today, and shows how to migrate old calls to the current model.

The GPT image family, explained

Here is the honest timeline. Treat it as a single product evolving, not a catalog.

GPT-4o image generation (March 25, 2025). OpenAI's first native image generator shipped inside GPT-4o. At launch you generated images by chatting with the model, not by calling a dedicated image endpoint. This is the thing people still call "the GPT-4o image API" — but at the start it was a capability of GPT-4o, not a standalone image model id.
GPT-Image-1 (April 23, 2025). OpenAI exposed that same capability to developers as a standalone API model, gpt-image-1. This is when "the GPT image API" became a real, callable thing with its own id — the model most "gpt-image-1 api documentation" searches are looking for.
GPT-Image-1.5 (December 16, 2025). An interim upgrade, launched broadly as "ChatGPT Images," with more precise edits and noticeably faster generation, available in the API the same day. If you are searching "gpt image 1.5 api," this is the model — and it has already been superseded.
GPT Image 2 (April 21, 2026). The current generation, branded ChatGPT Images 2.0. The headline change is that it is the first OpenAI image model with native reasoning — it effectively "thinks" before it draws — which shows up as stronger instruction-following, legible multi-script text rendered onto the image, and consistent subjects across a batch. It replaced both DALL-E 3 and GPT-Image-1.5 as the default.

(Lineage and dates: Wikipedia "GPT Image", and OpenAI's own "ChatGPT Images 2.0" announcement, both as of June 2026.)

The pattern is the important part. Each model replaced the one before it as OpenAI's standard image model. So at any given time there is essentially one current id worth building against; the older ids are legacy generations kept for backward compatibility, not because they are better at anything.

Which one to use today

Short answer: the current generation, GPT Image 2 (gpt-image-2/text-to-image).

There is no real scenario in mid-2026 where you would start a new integration on gpt-image-1 or gpt-image-1.5. They are earlier checkpoints of the same line — GPT Image 2 is better at the things you actually care about (following the prompt, putting correct text on the image, keeping a subject consistent across multiple outputs) and is the model that continues to get attention. New build, new code: go straight to gpt-image-2/text-to-image.

The only reason to care about the older names at all is migration — you have existing code that names gpt-image-1 or the old GPT-4o image path, and you need to move it forward.

One honesty note, because it changes the migration target: on HiAPI, the model available from this family is GPT Image 2 — the base model plus its Pro and image-to-image variants. HiAPI does not host gpt-image-1 or gpt-image-1.5 as callable models. That is not a limitation to work around; those are superseded generations, so the right move is to migrate to GPT Image 2, not to keep an old id alive. The one case this platform does not fit is if you specifically need previous-generation behavior — everywhere else, GPT Image 2 is the upgrade you wanted anyway.

Migration notes: GPT-4o image / GPT-Image-1 → GPT Image 2

On HiAPI, migrating an older GPT image integration means moving the request to the unified async task API and updating the model id. The current flow is to submit a task, poll or receive a callback, and then download the result.

Use the unified task API. HiAPI runs every image model through one async pattern: submit a job, poll until it is done, then download the result. Wherever your old code passed gpt-image-1 or invoked the GPT-4o image capability, submit a task with model gpt-image-2/text-to-image:

# 1) Submit a task — returns data.taskId
curl -s https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer sk-<your key>" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2/text-to-image","input":{"prompt":"a storefront sign that reads OPEN LATE, warm neon, dusk"}}'

# 2) Poll the task — data.status goes queued -> handling -> archiving -> success
curl -s https://api.hiapi.ai/v1/tasks/<taskId> \
  -H "Authorization: Bearer sk-<your key>"

# 3) On success, read data.output[0].url and download it now — the URL expires

One detail worth getting right: the model id for text-to-image requests is gpt-image-2/text-to-image. The same task request shape serves every model in the catalog, while the fields inside input vary by model.

Get an API key from the dashboard first (signup needs no card and currently includes $1 of free credit, around 50 images, to test real generations — see pricing). A 401 means the key is missing or invalid; a 403 means the key does not have permission. Full reference is in the docs. Your prompts can carry over to GPT Image 2, but the request must use the async task format shown above.

Which article to read next

This page is the hub. Once you know you are building on GPT Image 2, jump to the deep-dive that matches your actual question — each one goes far deeper than this map.

What does it cost? → GPT Image 2 API Pricing for per-image economics (live numbers on the pricing page).
Is it actually good? → GPT Image 2: An Honest Review — a hands-on take, strengths and weak spots.
How is the text rendering? → Does GPT Image 2 Really Nail Text? — signage, posters, and labels stress-tested.
Editing existing images? → GPT Image 2 Image-to-Image API Guide for the edit / variation path.
How does it compare to its main rival? → GPT Image 2 vs Nano Banana 2, same prompts, side by side.
API vs the ChatGPT UI? → ChatGPT Images 2 vs the GPT Image 2 API — when to use which.
Want prompts that work? → GPT Image 2 Prompt Templates with real outputs.
Building product images at scale? → GPT Image 2 E-commerce Workflow.
Still deciding across all models? → Best AI Image Generation API 2026 compares GPT Image 2 against the rest of the catalog.

Start anywhere; they all link back here.

FAQ

Is "GPT-4o image generation" the same as the GPT Image API? Effectively yes, at a point in time. GPT-4o image generation (March 2025) was OpenAI's first native image generator, living inside GPT-4o. It was exposed to developers as the gpt-image-1 API a month later, then evolved into GPT-Image-1.5 and now GPT Image 2. They are stages of one product, not separate APIs.

What is the difference between gpt-image-1, gpt-image-1.5, and gpt-image-2? They are successive generations of the same line, each replacing the last as the default. gpt-image-1 (April 2025) was the first standalone API model; gpt-image-1.5 (December 2025) added faster, more precise edits; gpt-image-2 (April 2026) added native reasoning and markedly better instruction-following and on-image text. For new work, use gpt-image-2/text-to-image.

Can I still call gpt-image-1 or gpt-image-1.5? On HiAPI, no — the family available is GPT Image 2 (plus its Pro and image-to-image variants). Those earlier ids are superseded generations, and the intended path is to migrate to GPT Image 2 rather than keep a legacy id running.

Do I need to rewrite my prompts when migrating to GPT Image 2? No. Prompts from earlier GPT image models carry over and usually come out better, since GPT Image 2 follows instructions more closely. Your prompt can carry over, but the API call must use the unified async task format and the current model id.

What is the correct model id, and why am I getting a 400? The text-to-image model id is gpt-image-2/text-to-image. If you hit a 400, check that the id is spelled exactly and that your prompt sits inside input.

Takeaways

OpenAI's image API is one evolving line — GPT-4o image → GPT-Image-1 → GPT-Image-1.5 → GPT Image 2 — where each model replaced the previous default. There is one current id worth using.
The current text-to-image model id is gpt-image-2/text-to-image.
If your code names gpt-image-1 or the old GPT-4o image path, the migration target is GPT Image 2 — and on HiAPI that is the only model from this family you can call, so migrating to it is the path, not a workaround.
Migration uses the unified async task API: submit with POST /v1/tasks, then poll GET /v1/tasks/:id or configure a callback. Your prompts can carry over, but the request shape must change.
Use this hub to orient, then go deep on the model page or the article that matches your job. Ready to call it? Sign up for free credit and make your first request.