Back to Models

Gemini 3 Pro Image

googlegoogle/gemini-3-pro-image

API guide

Async image generation

Submit image-generation jobs through TheRouter's OpenAI-compatible Images API. Use the async path for production so a long-running render does not hit request timeouts.

cURL
# 1) Submit an async generation job.
JOB=$(curl -s -X POST "https://api.therouter.ai/v1/images/generations?async=true"   -H "Authorization: Bearer $THEROUTER_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "google/gemini-3-pro-image",
    "prompt": "Create a clean 16:9 product hero image for an AI routing dashboard, dark background, teal highlights, crisp UI typography.",
    "size": "1792x1024",
    "n": 1
  }' | python3 -c "import sys,json;print(json.load(sys.stdin)["id"])")

# 2) Poll the job until it succeeds or fails.
while :; do
  R=$(curl -s "https://api.therouter.ai/v1/jobs/$JOB"     -H "Authorization: Bearer $THEROUTER_API_KEY")
  S=$(echo "$R" | python3 -c "import sys,json;print(json.load(sys.stdin)["status"])")
  echo "status: $S"
  case "$S" in
    succeeded) echo "$R" | python3 -c "import sys,json;print(json.load(sys.stdin)["unsigned_urls"][0])"; break ;;
    failed|cancelled|expired) echo "$R"; exit 1 ;;
  esac
  sleep 5
done

Async image editing

Use /v1/images/edits?async=true with multipart form data when the source image lives on disk. Gemini 3 Pro Image supports multi-turn editing on Google's native stack; keep your own job history so users can iterate safely.

cURL
JOB=$(curl -s -X POST "https://api.therouter.ai/v1/images/edits?async=true"   -H "Authorization: Bearer $THEROUTER_API_KEY"   -F "model=google/gemini-3-pro-image"   -F "prompt=Replace the headline with 'Route every model through one API' and keep the same layout."   -F "size=1024x1024"   -F "image=@input-poster.png" | python3 -c "import sys,json;print(json.load(sys.stdin)["id"])")

curl "https://api.therouter.ai/v1/jobs/$JOB"   -H "Authorization: Bearer $THEROUTER_API_KEY"
Fact ledger β€” every claim on this page traces here
sourceURLretrieved
Launch stagedocs.cloud.google.com β†—2026-07-25verified
Release datedocs.cloud.google.com β†—2026-07-25verified
Retirement datedocs.cloud.google.com β†—2026-07-25verified
Context windowdocs.cloud.google.com β†—2026-07-25verified
Maximum output tokensdocs.cloud.google.com β†—2026-07-25verified
Modalitiesdocs.cloud.google.com β†—2026-07-25verified
Maximum input imagesdocs.cloud.google.com β†—2026-07-25verified
Output resolutionsdocs.cloud.google.com β†—2026-07-25verified
Supported aspect ratiosdocs.cloud.google.com β†—2026-07-25verified
Supported image MIME typesdocs.cloud.google.com β†—2026-07-25verified
Input size limitdocs.cloud.google.com β†—2026-07-25verified
Input image accountingdocs.cloud.google.com β†—2026-07-25verified
Image output accountingcloud.google.com β†—2026-07-25verified
Standard Google list pricecloud.google.com β†—2026-07-25verified
Capabilitiesdocs.cloud.google.com β†—2026-07-25verified
Unsupported capabilitiesdocs.cloud.google.com β†—2026-07-25verified
Licenseβ€”β€”verified
Google model card β€” complex image generation and editingdocs.cloud.google.com β†—2026-07-25verified
Output-resolution supportdocs.cloud.google.com β†—2026-07-25verified
Gemini 3 Pro Image reaches GA as Nano Banana Prodocs.cloud.google.com β†—2026-07-25verified
Google publishes Gemini 3 Pro Image token pricingcloud.google.com β†—2026-07-25verified
Is Gemini 3 Pro Image available through an OpenAI-compatible API on TheRouter?therouter.ai β†—2026-07-25to verify
How much does Gemini 3 Pro Image cost per image?cloud.google.com β†—2026-07-25to verify
What image inputs and output sizes does Gemini 3 Pro Image support?docs.cloud.google.com β†—2026-07-25to verify
Does Gemini 3 Pro Image support function calling or structured JSON output?docs.cloud.google.com β†—2026-07-25to verify
Should I use Gemini 3 Pro Image or GPT Image 2?docs.cloud.google.com β†—2026-07-25to verify
Help & contact