GPT Image 2 - Oxen.ai

Try GPT Image 2 in the Workbench

Run this model interactively, tune parameters, and compare outputs.

Model ID: gpt-image-2 GPT Image 2 is OpenAI’s next-generation image model available through Fal. It produces photorealistic images with strong prompt adherence, pixel-perfect text rendering, and accurate handling of dense or multilingual layouts, making it suitable for infographics, UI mockups, product photography, and architectural visualization.

Example request

Use the Workbench as a request builder: configure parameters for this model in the UI, then open the API tab to copy the exact cURL or Python call.

Sync
Async
Async with SSE

See the image generation reference for more details.

Minimal
All parameters

curl -X POST https://hub.oxen.ai/api/ai/images/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "An ox standing in the middle of a long open road at sunset, cinematic lighting, photorealistic, centered and staring at the camera."
}'

curl -X POST https://hub.oxen.ai/api/ai/images/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "An ox standing in the middle of a long open road at sunset, cinematic lighting, photorealistic, centered and staring at the camera.",
  "resolution": "1024x1024",
  "quality": "high",
  "num_images": 1,
  "output_format": "png"
}'

See the async queue reference for more details.

Minimal
All parameters

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "An ox standing in the middle of a long open road at sunset, cinematic lighting, photorealistic, centered and staring at the camera."
}' | jq -r '.generations[0].generation_id')

# Poll until the generation reaches a terminal status.
while true; do
  STATUS=$(curl -s -H "Authorization: Bearer $OXEN_API_KEY" \
    "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq -r '.status')
  echo "Status: $STATUS"
  case $STATUS in succeeded|failed|cancelled) break;; esac
  sleep 5
done

# Print the result.
curl -s -H "Authorization: Bearer $OXEN_API_KEY" \
  "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq .

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "An ox standing in the middle of a long open road at sunset, cinematic lighting, photorealistic, centered and staring at the camera.",
  "resolution": "1024x1024",
  "quality": "high",
  "num_images": 1,
  "output_format": "png"
}' | jq -r '.generations[0].generation_id')

# Poll until the generation reaches a terminal status.
while true; do
  STATUS=$(curl -s -H "Authorization: Bearer $OXEN_API_KEY" \
    "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq -r '.status')
  echo "Status: $STATUS"
  case $STATUS in succeeded|failed|cancelled) break;; esac
  sleep 5
done

# Print the result.
curl -s -H "Authorization: Bearer $OXEN_API_KEY" \
  "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq .

See the async queue reference for more details.

Minimal
All parameters

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "An ox standing in the middle of a long open road at sunset, cinematic lighting, photorealistic, centered and staring at the camera."
}' | jq -r '.generations[0].generation_id')

# Stream the SSE channel, grab the data line that follows a
# media_generation_completed event for our id, and pretty-print it.
curl -sN -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/events \
  | awk -v id="$GEN_ID" '
    /^event: media_generation_completed$/ { expect=1; next }
    /^data: / && expect {
      payload = substr($0, 7)
      if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit }
      expect = 0
    }
  ' | jq .

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "An ox standing in the middle of a long open road at sunset, cinematic lighting, photorealistic, centered and staring at the camera.",
  "resolution": "1024x1024",
  "quality": "high",
  "num_images": 1,
  "output_format": "png"
}' | jq -r '.generations[0].generation_id')

# Stream the SSE channel, grab the data line that follows a
# media_generation_completed event for our id, and pretty-print it.
curl -sN -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/events \
  | awk -v id="$GEN_ID" '
    /^event: media_generation_completed$/ { expect=1; next }
    /^data: / && expect {
      payload = substr($0, 7)
      if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit }
      expect = 0
    }
  ' | jq .

Fetch model details

The models endpoint returns the full model object, including its json_request_schema.

curl -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/ai/models/gpt-image-2

Request parameters

Required parameters

Field	Type	Default	Description
`prompt`	`string`	`"An ox standing in the middle of a long open road at sunset, cinematic lighting, photorealistic, centered and staring at the camera."`	Text description of the image to generate.

Optional parameters

Field	Type	Default	Description
`resolution`	`string`	`"1024x1024"`	Output image resolution. HD sizes (1920x1080 and lower) bill at the standard tier; QHD+ sizes (2560x1440 and higher) bill at the high-resolution tier. One of: 1024x768, 1024x1024, 1024x1536, 1920x1080, 2560x1440, 3840x2160.
`quality`	`string`	`"high"`	Output quality tier. Locked to high for best fidelity. One of: high.
`num_images`	`integer`	`1`	Number of images to generate per request. Range: 1 – 4.
`output_format`	`string`	`"png"`	File format for the generated image. One of: png, jpeg, webp.

Inference API

Documentation Index

Try GPT Image 2 in the Workbench

​Example request

​Fetch model details

​Request parameters

​Required parameters

​Optional parameters

Example request

Fetch model details

Request parameters

Required parameters

Optional parameters