OpenAI logo

OpenAI: GPT Image 1 API

openai/gpt-image-1
Playground

GPT Image 1 API is the established baseline for production teams in this three-model OpenAI image catalog. It accepts text and image input, produces image output, and supports production controls through the dedicated Images API. [1]

Use GPT Image 1 API when an existing prompt library or quality baseline depends on this model. It supports generation and editing, but its official input rate is higher than the newer Image 1.5 and Image 2 entries. [1][2]

MODALITIES
Price$5 / $20 / 1MCONTEXT400K

Playground

Test GPT Image 1 API with representative production prompts before using gpt-image-1 in a live workflow.

Providers

OpenRouter lists GPT Image 1 API with text and image input, image output, and a 400K context window. APINEED routing and prepaid rates are identified separately. [1]

API Need50% off
Uptime
Total Context
400K
Max Output
N/A
Input
$5/ 1M
Output
$20/ 1M
Cache Read
$0.625/ 1M
Cache Write
Route priced

Discount

GPT Image 1 has the highest official input rate among the three listed image models. APINEED’s 50% discount reduces that rate, while accepted-result cost should guide high-volume use. The table compares official GPT Image 1 API pricing with the APINEED prepaid rate.

Official
Provider baseline
Input $10/ 1MOutput $40/ 1M
Baseline

Availability

APINEED continuously monitors GPT Image 1 API access and keeps requests on healthy capacity.

System statusLast 90 days
APINEED GATEWAY99.82% uptime

Quick Start

Call GPT Image 1 API through the Images API, then decode the base64 response. Send prompts and optional references to /v1/images, decode the base64 response, and preserve output metadata. Explicit quality and format settings make regression tests easier. [2]

1

Get your API key

Create an APINEED key for GPT Image 1 API and keep it in an environment variable.

export API_NEED_API_KEY=sk-apineed-v1-...
2

Generate and save an image

Send model and prompt to /v1/images. Each item in data contains a base64-encoded image.

import os
import base64
import requests

response = requests.post(
    "https://apineed.com/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['API_NEED_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "openai/gpt-image-1",
        "prompt": "A serene mountain landscape at sunset with dramatic clouds",
    },
)
response.raise_for_status()

for i, image in enumerate(response.json().get("data", [])):
    with open(f"output_{i}.png", "wb") as file:
        file.write(base64.b64decode(image["b64_json"]))
3

Use supported image controls

GPT Image 1 API accepts the controls listed for gpt-image-1; omit unsupported fields from image requests.

{
  "model": "openai/gpt-image-1",
  "prompt": "A serene mountain landscape at sunset with dramatic clouds",
  "quality": "high",
  "background": "transparent",
  "aspect_ratio": "1:1",
  "n": 1,
  "output_compression": 90
}

GPT Image 1 API Endpoint

Submit GPT Image 1 API generation or editing requests here. The API returns base64 images and can stream partial results when the model supports SSE. [2]

POST/v1/images/generations
Authorization
Bearer $API_NEED_API_KEY
Content-Type
application/json
HTTP-Referer
optional - your site URL, for rankings
Model
openai/gpt-image-1

Parameters

GPT Image 1 API image controls on the dedicated Images API, based on OpenRouter metadata for openai/gpt-image-1. [1][2]

NameTypeValuesDescription
aspect_ratioenum1:1, 3:2, 2:3, autoSelects the output image aspect ratio.
qualityenumauto, low, medium, highControls image rendering quality.
backgroundenumauto, transparent, opaqueControls whether the generated image uses an automatic, transparent, or opaque background.
nrange1-10Sets the number of images returned in one request.
input_referencesrange0-16Sets the number of reference images accepted for image-to-image generation or editing.
output_compressionrange0-100Sets JPEG or WebP compression from 0 to 100. It is ignored for PNG output.

GPT Image 1 API Q&A

Model-specific answers for teams comparing GPT Image 1 API on capability, benchmark evidence, integration, and cost.

Why use GPT Image 1 API instead of a newer image model?

Existing prompt validation, established visual behavior, or compatibility with a production baseline can justify retaining this model.

Does GPT Image 1 API support editing?

Yes. The endpoint accepts image input as well as text, and its published reference-image controls are listed in Parameters.

How should teams estimate image cost for GPT Image 1 API?

Measure the cost per accepted result, including retries and requested quality, rather than comparing token fields alone.

Can GPT Image 1 return multiple images?

For GPT Image 1 API, use the supported n parameter within the range shown on the page; each returned item contains base64-encoded image data.

Which endpoint serves GPT Image 1 API?

Send GPT Image 1 API requests to https://apineed.com/v1/images with gpt-image-1 as the model value. The data array returns base64-encoded images.

How do I validate GPT Image 1 API before release?

Test GPT Image 1 API with production prompts, reference images, supported controls, and an accepted-output cost target before shifting live image traffic.

How to Deploy the GPT Image 1 API on apineed.com

Deploy GPT Image 1 API through APINEED after validating its model-specific trade-offs above. The API key, credit, and endpoint flow stays consistent across the catalog.

1

Add credits for GPT Image 1 API

Add credits on APINEED before deploying the GPT Image 1 API. Pay-as-you-go billing lets usage start small and scale with production traffic.

2

Get your API key

Create an APINEED API key for the GPT Image 1 API. The same key can call GPT Image 1 and other AI APIs through apineed.com.

3

Set the model slug

Use gpt-image-1 as the model value when you deploy the GPT Image 1 API. Keep the APINEED base URL at https://apineed.com/v1.

4

Generate images with GPT Image 1 API

Send text or image prompts to the GPT Image 1 API from your app, workflow, or agent. Image output returns through one APINEED API layer.

More models from OpenAI