返回模型列表

Gemini 3.1 Flash Image

googlegoogle/gemini-3.1-flash-image

Google's GA image generation model built on Gemini 3.1 Flash. Supports text and image input/output for creative workflows with conversational multi-turn editing. Replaces gemini-3.1-flash-image-preview.

Gemini 3.1 Flash Image 是 Google GA 的 Nano Banana 图像模型中档位:适合需要高于 Lite 档生产质量、但不想承担 Pro 图像成本的团队。它支持文本和图像输入,并可输出文本或图像,因此适用于对话式图像创作、参考图编辑、营销变体和通过 TheRouter 承载的迭代设计工作流。

从运营角度看,它是 Gemini 图像系列中的均衡路由目标:便宜草稿走 Lite,生产可用的均衡任务走这个 Flash Image,精度和专业构图优先于成本时再走 Gemini 3 Pro Image。它也替代了旧的 gemini-3.1-flash-image-preview ID,因此硬编码的 preview 路由应移除,而不是继续留作 fallback。

适合使用
  • • 生产级营销图、缩略图、社媒变体和电商视觉:质量/成本平衡比最低单图价格更重要
  • • 参考图驱动的图片编辑和多轮创意精修:需要文本 + 图像输入,而不是一次性文生图端点
  • • 在 Gemini 图像模型之间设置 draft / balanced / pro 明确档位的路由策略
  • • 仍指向 gemini-3.1-flash-image-preview 或更老 Gemini 图像端点的应用迁移目标
不适合使用
  • • 超高吞吐构思或草稿生成:Gemini 3.1 Flash Lite Image 明确更便宜,速度也足够
  • • 精度关键的专业设计、密集文字排版或高端品牌工作:应优先路由到 Gemini 3 Pro Image
  • • 离线、开放权重或自托管部署——这是通过 TheRouter 提供的专有托管 Gemini API 模型

供应商自营与 TheRouter 服务形态的差异

供应商自己运营时

Google 原生 Gemini API 通过 generateContent 和 Gemini 专用图像生成指南描述 Gemini 图像模型。

在 TheRouter 上

TheRouter 通过 OpenAI 兼容 API 暴露同一模型 ID,使团队可将它与其他托管图像和多模态模型放在同一路由层,而无需直接调用 Google 原生 endpoint。

上下文长度
131K
最大输出
33K
输入价格每百万 tokens
$0.5494每百万 Tokens
输出价格每百万 tokens
$65.92每百万 Tokens

模态能力

文本图像→文本图像

能力

视觉理解图像生成

价格明细

类型费率
输入$0.5494 每百万 Tokens
输出$65.92 每百万 Tokens

Single blended output rate = the image-output rate ($60/MTok). Google also publishes a separate text/thinking output rate of $3/MTok that this schema cannot express, so non-image output tokens are over-billed. Source: ai.google.dev/gemini-api/docs/pricing, read 2026-07-29.

支持参数

temperaturemax_tokenstop_presponse_formatstop

模型规格

访问状态正式可用,替代 gemini-3.1-flash-image-previewai.google.dev changelog ↗已核实
输入 / 输出模态文本和图像输入;文本和图像输出ai.google.dev image generation docs ↗已核实
上下文窗口TheRouter 上为 131,072 tokensTheRouter API docs ↗已核实
最大输出TheRouter 上为 32,768 tokensTheRouter API docs ↗已核实
TheRouter 混合计费输入 $0.5494 / 百万 tokens;输出 $65.9232 / 百万 tokensTheRouter API docs ↗已核实
Google 原生图像输出费率图像输出为 $60 / 百万输出 tokens;Google 还单独发布文本/thinking 输出费率ai.google.dev pricing ↗已核实
TheRouter 支持参数temperature、max_tokens、top_p、response_format、stopTheRouter API docs ↗已核实
许可专有托管 API 模型;非开放权重ai.google.dev image generation docs ↗已核实

基准成绩

BenchmarkDistributionScoreSource
Public benchmark suite
Google 公开图像生成文档描述了能力和档位,但未发布 Gemini 3.1 Flash Image 的可比 benchmark 表。
—未公开披露—
Production latency
本次计划任务未进行需要资金的 live verification 或延迟 benchmark。
—未公开披露—
Image quality ranking
Google 将其定位为均衡的 Flash Image 档位,但没有公开可用于可靠数字分数的胜率或 Elo 表。
—未公开披露—

API 使用示例

所有新集成都应使用下方示例中的全球端点 api.therouter.ai;旧中国加速端点已下线。

建议使用异步 API

图像生成通常需要 30–180 秒,超过同步请求的边缘超时。下方示例已使用 ?async=true + 轮询模式。 查看异步图像生成 / 编辑完整指南 →

cURL
# 1) Submit job (returns 202 immediately with a polling URL).
# Image generation takes 30-180s — always use the async path in production.
JOB=$(curl -s -X POST "https://api.therouter.ai/v1/images/generations?async=true"   -H "Content-Type: application/json"   -H "Authorization: Bearer $THE_ROUTER_API_KEY"   -d '{
    "model": "google/gemini-3.1-flash-image",
    "prompt": "A cinematic product render with soft studio lighting"
  }' | python3 -c "import sys,json;print(json.load(sys.stdin)['id'])")
echo "submitted: $JOB"

# 2) Poll until terminal (succeeded / failed / cancelled / expired).
while :; do
  R=$(curl -s "https://api.therouter.ai/v1/jobs/$JOB"     -H "Authorization: Bearer $THE_ROUTER_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

API 使用指南

完整 API 参考 →

多模态图像生成

将文本提示发送到 TheRouter 的 OpenAI 兼容 chat endpoint,并在需要均衡 Google 图像档位时指定 Gemini 3.1 Flash Image。

cURL
curl https://api.therouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $THEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image",
    "messages": [
      {
        "role": "user",
        "content": "Create a square product hero image for a ceramic travel mug on a warm studio background."
      }
    ],
    "max_tokens": 1024
  }'

图像编辑示例

上传一张图片并用文本 prompt 描述编辑要求;模型会返回编辑后的图片(base64)。

cURL
# Same async submit + poll pattern as /v1/images/generations.
JOB=$(curl -s -X POST "https://api.therouter.ai/v1/images/edits?async=true"   -H "Authorization: Bearer $THE_ROUTER_API_KEY"   -F "model=google/gemini-3.1-flash-image"   -F "prompt=Turn this scene into a watercolor painting"   -F "size=1024x1024"   -F "image=@input.png" | python3 -c "import sys,json;print(json.load(sys.stdin)['id'])")
echo "submitted: $JOB"

while :; do
  R=$(curl -s "https://api.therouter.ai/v1/jobs/$JOB"     -H "Authorization: Bearer $THE_ROUTER_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

google 其他模型

同类模型

跨供应商的相似能力档位

动态与变更

2026-07-08

Nano Banana 2 Lite 成为新的默认 Gemini 图像端点:路由决策框架

Google 的 Nano Banana 系列已形成更清晰的 Lite、均衡 Flash Image 和 Pro Image 三档。对 TheRouter 运维者来说,Gemini 3.1 Flash Image 是该路由策略中的均衡分支;Lite 处理草稿,Pro 处理高端精度关键任务。

TheRouter 编辑重写blog.google ↗
2026-06-20

2026 年 Gemini API 图像生成:preview 关停后修复 failed to fetch

Google 的图像 preview ID 已由 GA Gemini 图像模型替代。仍路由到 gemini-3.1-flash-image-preview 的团队应迁移到 Gemini 3.1 Flash Image,并从 fallback 链移除 preview 字符串。

TheRouter 编辑重写ai.google.dev changelog ↗

常见问题

什么时候应选择 Gemini 3.1 Flash Image,而不是 Lite 或 Pro?

把它作为均衡生产档位:它比 Lite 更适合面向客户的资产,又比 Pro 更适合不需要最高专业精度的任务。草稿走 Lite,精度关键的品牌或设计工作走 Pro。

google/gemini-3.1-flash-image 是 preview ID 的替代品吗?

是。Google 2026 年图像废弃迁移将团队从 gemini-3.1-flash-image-preview 迁到 GA 的 gemini-3.1-flash-image。生产路由表应使用 GA ID,并移除 preview fallback。

TheRouter 编辑重写ai.google.dev changelog ↗
本页代码片段是否经过 live verification?

没有。本次计划化补全没有付费 API 预算,因此未执行代码片段,也未新增 verification ledger 记录。在 operator 批准付费 snippet run 之前,应将示例视为实现模板。

事实档案 — 本页每条断言可在此回溯来源
来源URL采集于
访问状态ai.google.dev changelog ↗2026-08-05已核实
输入 / 输出模态ai.google.dev image generation docs ↗2026-08-05已核实
上下文窗口TheRouter API docs ↗2026-08-05已核实
最大输出TheRouter API docs ↗2026-08-05已核实
TheRouter 混合计费TheRouter API docs ↗2026-08-05已核实
Google 原生图像输出费率ai.google.dev pricing ↗2026-08-05已核实
TheRouter 支持参数TheRouter API docs ↗2026-08-05已核实
许可ai.google.dev image generation docs ↗2026-08-05已核实
Public benchmark suiteai.google.dev image generation docs ↗2026-08-05未知
Production latencyTheRouter API docs ↗2026-08-05未知
Image quality rankingai.google.dev image generation docs ↗2026-08-05未知
Nano Banana 2 Lite 成为新的默认 Gemini 图像端点:路由决策框架blog.google ↗2026-08-05已核实
2026 年 Gemini API 图像生成:preview 关停后修复 failed to fetchai.google.dev changelog ↗2026-08-05已核实
什么时候应选择 Gemini 3.1 Flash Image,而不是 Lite 或 Pro?ai.google.dev image generation docs ↗2026-08-05待核实
google/gemini-3.1-flash-image 是 preview ID 的替代品吗?ai.google.dev changelog ↗2026-08-05待核实
本页代码片段是否经过 live verification?TheRouter API docs ↗2026-08-05待核实
帮助与联系