OpenAI · Media API

GPT-Image 2.5 API

GPT-Image 2.5 is OpenAI's newer image model on OmniaKey, covering text-to-image generation and inline Base64 edits while returning exactly the size you request.

Get your API key Read the docs

Model ID: gpt-image-2.5
Provider: OpenAI
Modality: AI Image
Per successful call: $0.10
Last verified: 2026-09-11

Where it fits

Use GPT-Image 2.5 for higher-fidelity generations and reference edits where honoring the requested output size matters; choose GPT-Image 2 when the lower per-call price is the priority.

What it does

Text to image

Turn a text prompt into a new image.

Image edit

Change an existing image from a prompt and reference input.

Call it

Media models run asynchronously. Create a task, poll it until it finishes, then download the signed asset URL.

Create, poll, download

# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gpt-image-2.5-001" \
  -d '{
    "model": "gpt-image-2.5",
    "type": "image",
    "operation": "generate",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"size": "1024x1024", "quality": "medium"}
  }'

# 2. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 3. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"

Pricing

Image jobs are billed per successful call, not per token. Failed or canceled jobs are refunded automatically.

Per successful call

$0.10per call

More OpenAI image models

GPT-Image 2

gpt-image-2

Frequently asked questions

How do I call GPT-Image 2.5 on OmniaKey?

POST to /v1/media/tasks with the model id, type "image", and operation "generate" or "edit". Reuse one Idempotency-Key across retries so a timeout never starts a second paid job.

What does GPT-Image 2.5 cost?

GPT-Image 2.5 bills $0.10 per call. Creation pre-charges that amount from your prepaid balance, and failed or canceled jobs are refunded automatically.

Why does the API return a task id instead of the image?

Provider latency runs from seconds to about a minute, so OmniaKey normalizes every image route into one asynchronous lifecycle. Poll GET /v1/media/tasks/{id} until the status is succeeded, then read the signed asset URL.