返回模型列表

Gemini 3 Pro Image

googlegoogle/gemini-3-pro-image

API 使用指南

异步图像生成

通过 TheRouter 的 OpenAI 兼容 Images API 提交图像生成任务。生产环境建议使用异步路径,避免长时间渲染触发请求超时。

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

异步图像编辑

源图在本地磁盘时,使用 /v1/images/edits?async=true 和 multipart form data。Gemini 3 Pro Image 在 Google 原生栈支持多轮编辑;请保留自己的任务历史,方便用户安全迭代。

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"
事实档案 — 本页每条断言可在此回溯来源
来源URL采集于
发布阶段docs.cloud.google.com ↗2026-07-25已核实
发布日期docs.cloud.google.com ↗2026-07-25已核实
退役日期docs.cloud.google.com ↗2026-07-25已核实
上下文窗口docs.cloud.google.com ↗2026-07-25已核实
最大输出 tokendocs.cloud.google.com ↗2026-07-25已核实
模态docs.cloud.google.com ↗2026-07-25已核实
最大输入图像数docs.cloud.google.com ↗2026-07-25已核实
输出分辨率docs.cloud.google.com ↗2026-07-25已核实
支持宽高比docs.cloud.google.com ↗2026-07-25已核实
支持图像 MIME 类型docs.cloud.google.com ↗2026-07-25已核实
输入大小限制docs.cloud.google.com ↗2026-07-25已核实
输入图像计费 tokendocs.cloud.google.com ↗2026-07-25已核实
图像输出计费 tokencloud.google.com ↗2026-07-25已核实
Google 标准标价cloud.google.com ↗2026-07-25已核实
能力docs.cloud.google.com ↗2026-07-25已核实
不支持能力docs.cloud.google.com ↗2026-07-25已核实
许可——已核实
Google model card — complex image generation and editingdocs.cloud.google.com ↗2026-07-25已核实
Output-resolution supportdocs.cloud.google.com ↗2026-07-25已核实
Gemini 3 Pro Image 以 Nano Banana Pro 品牌 GAdocs.cloud.google.com ↗2026-07-25已核实
Google 公布 Gemini 3 Pro Image token 定价cloud.google.com ↗2026-07-25已核实
Gemini 3 Pro Image 可以通过 TheRouter 的 OpenAI 兼容 API 调用吗?therouter.ai ↗2026-07-25待核实
Gemini 3 Pro Image 每张图多少钱?cloud.google.com ↗2026-07-25待核实
Gemini 3 Pro Image 支持哪些图像输入和输出尺寸?docs.cloud.google.com ↗2026-07-25待核实
Gemini 3 Pro Image 支持函数调用或结构化 JSON 输出吗?docs.cloud.google.com ↗2026-07-25待核实
应该用 Gemini 3 Pro Image 还是 GPT Image 2?docs.cloud.google.com ↗2026-07-25待核实
帮助与联系