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
doneAsync 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
| source | URL | retrieved | |
|---|---|---|---|
| Launch stage | docs.cloud.google.com β | 2026-07-25 | verified |
| Release date | docs.cloud.google.com β | 2026-07-25 | verified |
| Retirement date | docs.cloud.google.com β | 2026-07-25 | verified |
| Context window | docs.cloud.google.com β | 2026-07-25 | verified |
| Maximum output tokens | docs.cloud.google.com β | 2026-07-25 | verified |
| Modalities | docs.cloud.google.com β | 2026-07-25 | verified |
| Maximum input images | docs.cloud.google.com β | 2026-07-25 | verified |
| Output resolutions | docs.cloud.google.com β | 2026-07-25 | verified |
| Supported aspect ratios | docs.cloud.google.com β | 2026-07-25 | verified |
| Supported image MIME types | docs.cloud.google.com β | 2026-07-25 | verified |
| Input size limit | docs.cloud.google.com β | 2026-07-25 | verified |
| Input image accounting | docs.cloud.google.com β | 2026-07-25 | verified |
| Image output accounting | cloud.google.com β | 2026-07-25 | verified |
| Standard Google list price | cloud.google.com β | 2026-07-25 | verified |
| Capabilities | docs.cloud.google.com β | 2026-07-25 | verified |
| Unsupported capabilities | docs.cloud.google.com β | 2026-07-25 | verified |
| License | β | β | verified |
| Google model card β complex image generation and editing | docs.cloud.google.com β | 2026-07-25 | verified |
| Output-resolution support | docs.cloud.google.com β | 2026-07-25 | verified |
| Gemini 3 Pro Image reaches GA as Nano Banana Pro | docs.cloud.google.com β | 2026-07-25 | verified |
| Google publishes Gemini 3 Pro Image token pricing | cloud.google.com β | 2026-07-25 | verified |
| Is Gemini 3 Pro Image available through an OpenAI-compatible API on TheRouter? | therouter.ai β | 2026-07-25 | to verify |
| How much does Gemini 3 Pro Image cost per image? | cloud.google.com β | 2026-07-25 | to verify |
| What image inputs and output sizes does Gemini 3 Pro Image support? | docs.cloud.google.com β | 2026-07-25 | to verify |
| Does Gemini 3 Pro Image support function calling or structured JSON output? | docs.cloud.google.com β | 2026-07-25 | to verify |
| Should I use Gemini 3 Pro Image or GPT Image 2? | docs.cloud.google.com β | 2026-07-25 | to verify |