GPT Image 2

Text-to-image generation with photorealistic output, accurate text rendering, and strong prompt adherence.

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

See the image generation reference for more details.

Minimal

cURL

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."
}'

All parameters

cURL

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"
}'

Async

See the async queue reference for more details.

Minimal

cURL

# 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 the single generation until it 404s (terminal state).
while curl -s -o /dev/null -w "%{http_code}" \
    -H "Authorization: Bearer $OXEN_API_KEY" \
    "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | grep -q "^200$"; do
  sleep 5
done
echo "Done. See the 'Async with SSE' tab to receive the result URL."

All parameters

cURL

# 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 the single generation until it 404s (terminal state).
while curl -s -o /dev/null -w "%{http_code}" \
    -H "Authorization: Bearer $OXEN_API_KEY" \
    "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | grep -q "^200$"; do
  sleep 5
done
echo "Done. See the 'Async with SSE' tab to receive the result URL."

Async with SSE

See the async queue reference for more details.

Minimal

cURL

# 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 .

All parameters

cURL

# 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.