GPT Image 2 API
OpenAI SOTA image model. Photoreal output, dense text rendering, precise editing.
Integrate GPT Image 2 with a single API call — one key, one unified endpoint, and shared billing across every model on Apiframe.
model: "gpt-image-2" What's special about GPT Image 2
- Aspect ratios: 1:1, 3:2, 2:3.
- Image-to-image editing and reference-image support.
- Fast turnaround — about 15s per generation on average.
- Pay-as-you-go pricing with no OpenAI account required — you only pay for successful generations.
- One API key, unified billing, idempotency and webhooks across every Apiframe model.
Made with GPT Image 2
A few outputs generated through the GPT Image 2 API on Apiframe.
A cinematic portrait of an astronaut in a neon-lit alley, 85mm, shallow depth of field
Cozy isometric coffee shop, warm morning light, highly detailed 3D render
A majestic snow leopard on a misty mountain ridge at golden hour
Overview
- Endpoint
- POST /v2/images/generate
- Model ID
- gpt-image-2
- Params key
- gptImage2Params
- Modality
- image
- Provider
- OpenAI
- Pricing
- Pay-as-you-go
- Avg. completion
- ~15s
Capabilities
Quick start
Send a single POST /v2/images/generate request with your API key to
generate with GPT Image 2. The call returns a jobId you can poll or
receive via webhook.
curl -X POST https://api.apiframe.ai/v2/images/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "gpt-image-2",
"gptImage2Params": {
"input_images": "https://example.com/input.jpg",
"quality": "auto",
"background": "auto",
"number_of_images": 1
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/images/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "gpt-image-2",
"gptImage2Params": {
"input_images": "https://example.com/input.jpg",
"quality": "auto",
"background": "auto",
"number_of_images": 1
}
},
)
print(response.json()) # { "jobId": "...", "status": "QUEUED" }const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "gpt-image-2",
"gptImage2Params": {
"input_images": "https://example.com/input.jpg",
"quality": "auto",
"background": "auto",
"number_of_images": 1
}
}),
});
const { jobId } = await response.json();
console.log(jobId);Response & job lifecycle
Generation is asynchronous. A successful submission returns 202 Accepted
with a jobId. Poll GET /v2/jobs/{id} (or supply a
webhook_url) until the status is COMPLETED; the
result field then holds the output URL(s).
1. Submission response (202)
{
"jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"status": "QUEUED"
}2. Poll for the result
curl https://api.apiframe.ai/v2/jobs/JOB_ID \
-H "X-API-Key: afk_your_api_key_here"import requests, time
while True:
job = requests.get(
"https://api.apiframe.ai/v2/jobs/JOB_ID",
headers={"X-API-Key": "afk_your_api_key_here"},
).json()
if job["status"] in ("COMPLETED", "FAILED"):
break
time.sleep(2)
print(job["result"])let job;
do {
await new Promise((r) => setTimeout(r, 2000));
job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
headers: { "X-API-Key": "afk_your_api_key_here" },
}).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);Input schema
Request parameters accepted by the GPT Image 2 endpoint. Model-specific options are nested under the params object shown below.
| Parameter | Type | Required | Default | Allowed / range | Description |
|---|---|---|---|---|---|
| prompt | string | required | — | — | Text description of what to generate. |
| model | string | required | "gpt-image-2" | "gpt-image-2" | The model identifier for this endpoint. |
| gptImage2Params.input_images | string (URL) | optional | — | — | Reference image (URL) |
| gptImage2Params.quality | string | optional | "auto" | "auto", "low", "medium", "high" | Quality |
| gptImage2Params.background | string | optional | "auto" | "auto", "opaque" | Background |
| gptImage2Params.number_of_images | number | optional | 1 | min 1, max 10, step 1 | Number of images |
| gptImage2Params.output_format | string | optional | "webp" | "webp", "png", "jpeg" | Output format |
| gptImage2Params.moderation | string | optional | "auto" | "auto", "low" | How strictly to filter content. Use "low" for less restrictive moderation. |
Frequently Asked Questions
Common questions about the GPT Image 2 API.
Is there an API for GPT Image 2?
Yes. Apiframe exposes GPT Image 2 through a single REST endpoint (`POST /v2/images/generate` with `model: "gpt-image-2"`). You get one unified API, key, and billing across every supported model — no separate OpenAI account required.
How much does the GPT Image 2 API cost?
GPT Image 2 uses simple pay-as-you-go pricing on Apiframe — you only pay for successful generations. See the pricing page for plans and volume discounts.
How do I call the GPT Image 2 API?
Send a POST request to `/v2/images/generate` with your `X-API-Key` and a JSON body containing `model: "gpt-image-2"`. The call returns a `jobId`; poll `GET /v2/jobs/{id}` or use a webhook to receive the result.
What parameters does GPT Image 2 support?
GPT Image 2 accepts 6 model-specific parameters (nested under `gptImage2Params`) plus the common `prompt` and `webhook_url` fields. See the input schema above for the full list with types and defaults.
Still have questions?
Start building with the GPT Image 2 API
Get your API key and integrate GPT Image 2 in minutes — Pay-as-you-go.
Questions? Join our Discord or contact sales.