OpenAI modelsimage generation api

openai/gpt-image-2

Name: GPT Image 2
Author: OpenAI

GPT Image 2, OpenAI's latest image model, is capable of making fine-grained, detailed edits to images.

Input

Prompt(string)

The text prompt to generate an image from.

Quality(string)

Quality for the generated image Allowed values: low, medium, high.

Resolution(string)

The resolution of the generated image. Leave unset to preserve the provider's standard dimensions. Allowed values: 1k, 2k, 4k.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9.

Output Format(string)

The format of the generated image. Allowed values: jpeg, png, webp.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDopenai/gpt-image-2

Input Schema

5 parameters · 1 required · 4 optional

Parameter	Type	Required	Description
`prompt`	string	Required	The text prompt to generate an image from. · Min length: 3 · Max length: 50000 · Default: "Generate an image of gray tabby cat hugging an otter with an orange scarf"
`quality`	string	Optional	Quality for the generated image · Options: low, medium, high · Default: "high" lowmediumhigh
`resolution`	string	Optional	The resolution of the generated image. Leave unset to preserve the provider's standard dimensions. · Options: 1k, 2k, 4k 1k2k4k
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9 · Default: "1:1" 1:11:22:11:33:12:33:23:44:34:55:49:1616:99:2121:9
`output_format`	string	Optional	The format of the generated image. · Options: jpeg, png, webp · Default: "png" jpegpngwebp

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "openai/gpt-image-2",
  "prompt": "Generate an image of gray tabby cat hugging an otter with an orange scarf",
  "quality": "high",
  "aspect_ratio": "1:1",
  "output_format": "png"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to GPT Image 2

API README

OpenAI GPT Image 2 Text-to-Image

OpenAI's most capable image generation model. Excels at complex scenes with accurate text rendering, strong prompt adherence, and photorealistic output across Latin and CJK scripts.

Need to edit an existing image? Try OpenAI GPT Image 2 Edit.

Highlights

Near-perfect text rendering — Generates readable text inside images including signage, UI labels, handwritten notes, and posters. Supports Chinese, Japanese, Korean, and Latin scripts with correct spelling and consistent spacing.

Extreme prompt adherence — Follows complex multi-part instructions faithfully. Composition, lighting, material properties, and fine-grained details described in long prompts are preserved without drift.

Neutral, accurate color — Eliminates the warm color cast present in earlier models. Colors render true-to-intent across all scene types, critical for brand assets and product photography.

Flexible resolution up to 4K — Supports preset sizes and custom dimensions. Both edges must be multiples of 16, max single edge 3840px, total pixels between 655K and 8.3M.

Pricing

Quality	Standard Size	Large (21:9 / 9:21)
Low	$0.015	$0.03
Medium	$0.05	$0.08
High	$0.20	$0.30

Standard covers most aspect ratios (1:1, 2:3, 3:2, 4:3, 16:9, etc). Large applies to ultra-wide/tall formats only.

When to Use

✅ Good fit	❌ Consider alternatives
Text-heavy images (posters, ads, packaging)	Simple icons or flat illustrations
Complex multi-object scenes	Real-time / sub-second generation
Brand-accurate color requirements	Iterative mask-based editing (use Edit model)
Multilingual text in images	Video or animation
Product mockups and concept art	Extremely large batch jobs on budget

Prompt Guide

Structure your prompts for best results:

Scene: [environment, time of day, background]
Subject: [main focus, position, action]
Details: [materials, lighting, camera angle, mood]
Text: [exact text to render, font style, placement]
Constraints: [no watermark, specific aspect ratio, color palette]

Example:

A minimalist product photo of a ceramic coffee mug on a marble countertop, morning sunlight from the left, soft shadows. The mug has "Good Morning" written in a clean serif font. White background, 3:2 aspect ratio, no other objects.

Technical Specs

Spec	Value
Input	Text prompt (max 32,000 characters)
Output	PNG, JPEG, or WebP
Resolution	655,360 – 8,294,400 total pixels
Max edge	3,840 px
Aspect ratio	Up to 3:1
Edge constraint	Multiples of 16
Execution	Async (submit → poll for result)

OpenAI GPT Image 2 Edit — Edit existing images with multi-image input support