The GPT Image API is OpenAI's hosted interface for generating and editing images, with a model identifier selecting the image model used for a request. GPT Image 1 accepts text and image inputs and produces images through OpenAI's service; it has no open weights for local inference. Use the authenticated Images API for a direct integration, and check the model's lifecycle before choosing it for an application. GPT Image 1 documentation OpenAI image generation guide
What are the key facts about the GPT Image API?
| Field | Verified information |
|---|---|
| Developer | OpenAI. GPT Image 1 documentation |
| Released | GPT Image 1 entered the API on April 23, 2025. OpenAI changelog |
| Type | Hosted multimodal image generation and editing model. GPT Image 1 documentation |
| Size or parameters | Not published in OpenAI's model documentation. GPT Image 1 documentation |
| License and access | Hosted API access under OpenAI's service terms; no open-weight distribution is provided. GPT Image 1 documentation OpenAI image generation guide |
| Where it runs | OpenAI's service, called through authenticated API requests. OpenAI image generation guide |
| Lifecycle | OpenAI lists October 23, 2026 as GPT Image 1's shutdown date and GPT Image 2 as its replacement. OpenAI deprecation schedule |
What can an application do with the GPT Image API?
The practical value of the Images API is that generation can become an explicit application operation. A request identifies the model and supplies the prompt, while image editing adds visual input. OpenAI documents generation and editing as separate capabilities, allowing an application to choose the operation that matches the user's task. OpenAI image generation guide
For integration design, define the finished asset before defining the form fields. A product illustration may need a particular aspect ratio and a clear central subject. A campaign draft may require approved words and room for additional layout work. Translate those requirements into a repeatable prompt and output configuration.
OpenAI documents generation and editing endpoints for GPT Image 1. Test a new image and a revision of existing material through those hosted endpoints. OpenAI changelog OpenAI image generation guide
Keep the first application flow narrow: collect the brief, submit one request, save the returned image, and let the user review it. Measure how often that flow produces an acceptable draft before adding automatic retries or a queue of variants. Include rejected drafts in the trial record.
How much does GPT Image 1 cost, and when does it retire?
Model availability is an immediate integration constraint. OpenAI's deprecation schedule lists October 23, 2026 as GPT Image 1's shutdown date. Existing applications should test their replacement path before that date. A model card remaining online does not cancel a published shutdown notice. OpenAI deprecation schedule
Cost is configuration-dependent. The GPT Image 1 page lists square 1024-by-1024 output at $0.011 for low quality, $0.042 for medium, and $0.167 for high. These output figures should not be presented as a universal complete-request price; input token usage also contributes to billing. GPT Image 1 documentation OpenAI pricing
GPT Image 1's model page lists standard rates of $5 per million text input tokens, $10 per million image input tokens, and $40 per million image output tokens. Use those model-specific rates when estimating an existing integration. GPT Image 1 documentation
OpenAI also documents limitations involving exact text placement, visual consistency, and structured compositions. Treat an image response as material requiring review, especially when the asset includes a name, label, or brand detail. These documented limitations are reasons to define acceptance criteria rather than infer perfect compliance from a successful response. OpenAI image generation guide
For a cost trial, record every paid attempt needed to finish the asset, including edits and rejected drafts. Divide observed spending by accepted outputs. That measurement answers a more useful production question than the price of an isolated example image.
How do you test an existing GPT Image 1 integration?
Obtain authorized API access and configure OPENAI_API_KEY securely in your server environment. OpenAI says organization verification may be required for GPT Image access. The following direct request is useful for checking an existing GPT Image 1 integration while planning its migration. OpenAI image generation guide OpenAI deprecation schedule
curl https://api.openai.com/v1/images/generations \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-image-1",
"prompt": "A watercolor illustration of a red bicycle beside a garden gate, with generous empty space above.",
"size": "1024x1024",
"quality": "low"
}'
Decode the returned data[0].b64_json field and save the image bytes to a file. The official guide demonstrates this response-handling pattern for the Images API. Check for an error response before attempting to decode an image field. OpenAI image generation guide
For application work, separate the following stages:
- Validate the user's brief and select an explicitly supported model identifier.
- Submit the request from the application server with the intended output settings.
- Handle API errors as errors, rather than creating an empty image record.
- Save the returned asset together with the prompt and model identifier.
- Ask the user to inspect the result against the original brief.
- Record observed usage and completion time for the evaluation.
Keep model selection in a place that can be updated without rewriting the entire user flow. For the scheduled transition, compare outputs on the same representative briefs and document any prompt or format changes you make.
PromptZone's GPT Image 2 editing guide covers reference-image work with the replacement model. The ComfyUI guide offers broader context when deciding how a managed image service fits into a larger visual workflow.
How should you compare GPT Image 1 with GPT Image 2?
| Option | Documented access and lifecycle |
|---|---|
| GPT Image 1 | Hosted generation and editing; scheduled for API removal on October 23, 2026. GPT Image 1 documentation OpenAI deprecation schedule |
| GPT Image 2 | OpenAI's replacement image model, with generation, editing, and flexible output dimensions. GPT Image 2 documentation |
For an existing integration, the comparison should be a migration trial using actual assets and acceptance criteria. For a new integration, the published retirement schedule is a concrete reason to evaluate the replacement first.
Keep your cost comparison tied to complete jobs. A cheap draft that needs several revisions and an expensive draft accepted immediately represent different workflows. Record what happened in your trial and keep that observation separate from the provider's published rates.
What else should you know about GPT Image API access?
Can I download GPT Image 1 and run it offline?
OpenAI provides GPT Image 1 through its hosted API, without open weights. The documented access path is an authenticated service request. GPT Image 1 documentation OpenAI image generation guide
Does every GPT Image request cost the same amount?
GPT Image API costs vary by model and request configuration. GPT Image 1's model page lists separate input and output token rates, plus output estimates by quality and dimensions; count all attempts when estimating a finished asset. GPT Image 1 documentation
Should a new application start with GPT Image 1?
OpenAI schedules GPT Image 1's shutdown for October 23, 2026 and names GPT Image 2 as the replacement. Evaluate the replacement for new work and use GPT Image 1 trials where they help migrate an existing integration. OpenAI deprecation schedule
Do I need a local GPU to call the Images API?
Calling the GPT Image API sends a request to OpenAI's hosted service. You do not load or run the model on a local GPU. OpenAI image generation guide
Sources
- GPT Image 1 model documentation
- OpenAI image generation guide
- OpenAI API changelog
- OpenAI API deprecations
- OpenAI API pricing
- GPT Image 2 model documentation
Top comments (0)