OpenAI logo

OpenAI: GPT Image 2 API

openai/gpt-image-2
Playground

GPT Image 2 API is the newest OpenAI image model in this catalog, designed for text-to-image generation and reference-based editing through the dedicated Images API. It is the first choice to evaluate when output quality takes priority. [1]

The endpoint accepts text and image input and returns base64-encoded image data. GPT Image 2 API exposes quality, background, batch count, reference-image, and compression controls, giving production pipelines explicit output choices. [1][2]

MODALITIES
Price$4 / $15 / 1MCONTEXT400K

Playground

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

Providers

OpenRouter lists GPT Image 2 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
$4/ 1M
Output
$15/ 1M
Cache Read
$1/ 1M
Cache Write
Route priced

Discount

GPT Image 2 carries the catalog’s lower official input rate among GPT Image 1 and 2 while retaining a premium image-output charge. APINEED applies the listed 50% reduction. The table compares official GPT Image 2 API pricing with the APINEED prepaid rate.

Official
Provider baseline
Input $8/ 1MOutput $30/ 1M
Baseline

Availability

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

System statusLast 90 days
APINEED GATEWAY99.49% uptime

Quick Start

Call GPT Image 2 API through the Images API, then decode the base64 response. Use reference images for controlled edits, set quality intentionally, and choose compression only for JPEG or WebP output. Decode each b64_json item before storing or serving it. [2]

1

Get your API key

Create an APINEED key for GPT Image 2 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-2",
        "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 2 API accepts the controls listed for gpt-image-2; omit unsupported fields from image requests.

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

GPT Image 2 API Endpoint

Submit GPT Image 2 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-2

Parameters

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

NameTypeValuesDescription
aspect_ratioenum1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, autoSelects the output image aspect ratio.
qualityenumauto, low, medium, highControls image rendering quality.
backgroundenumauto, 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 2 API Q&A

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

What distinguishes GPT Image 2 API in this catalog?

It is the newest listed GPT Image model and exposes generation, editing, reference-image, quality, background, and compression controls.

How many reference images can GPT Image 2 API receive?

Its published input_references range is shown in the Parameters table and should be treated as the endpoint limit.

When does output compression apply for GPT Image 2 API?

Use it for JPEG or WebP responses; the parameter is ignored when the requested output format is PNG.

How should I compare image quality for GPT Image 2?

For GPT Image 2 API, run the same prompt and references across models, then inspect prompt adherence, edit fidelity, text rendering, artifacts, and cost per accepted result.

Which endpoint serves GPT Image 2 API?

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

How do I validate GPT Image 2 API before release?

Test GPT Image 2 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 2 API on apineed.com

Deploy GPT Image 2 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 2 API

Add credits on APINEED before deploying the GPT Image 2 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 2 API. The same key can call GPT Image 2 and other AI APIs through apineed.com.

3

Set the model slug

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

4

Generate images with GPT Image 2 API

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

More models from OpenAI