返回模型列表
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 | 已核实 |
| 最大输出 token | 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 | 已核实 |
| 支持宽高比 | docs.cloud.google.com ↗ | 2026-07-25 | 已核实 |
| 支持图像 MIME 类型 | docs.cloud.google.com ↗ | 2026-07-25 | 已核实 |
| 输入大小限制 | docs.cloud.google.com ↗ | 2026-07-25 | 已核实 |
| 输入图像计费 token | docs.cloud.google.com ↗ | 2026-07-25 | 已核实 |
| 图像输出计费 token | cloud.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 editing | docs.cloud.google.com ↗ | 2026-07-25 | 已核实 |
| Output-resolution support | docs.cloud.google.com ↗ | 2026-07-25 | 已核实 |
| Gemini 3 Pro Image 以 Nano Banana Pro 品牌 GA | docs.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 | 待核实 |