GPT-5.4 和 GPT-5.4 Mini 已下线 · 请切换至其他可用模型
全部模型
Google · 媒体 API

Nano Banana 2 (Preview) API

Nano Banana 2(Preview)是 Google Gemini 3.1 Flash 图像路由的预览快照,通过预览模型 ID 提供相同的文生图与编辑能力。

模型 ID
gemini-3.1-flash-image-preview
提供商
Google
类型
AI 图片
每次成功调用
$0.05
最近核验
2026-09-11

01

适用场景

预览 ID 只用于有意评估新快照;计划长期运行的生产任务请使用稳定的 Nano Banana 2 模型 ID。

02

能力范围

文生图

把文字提示词生成一张新图片。

图片编辑

根据提示词和参考图修改已有图片。

03

接入方式

媒体模型采用异步任务:创建任务、轮询到完成,再下载签名后的资源地址。

创建、轮询、下载
# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gemini-3.1-flash-image-preview-001" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "type": "image",
    "operation": "generate",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"size": "1024x1024", "quality": "medium"}
  }'

# 2. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 3. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"

04

价格

图像任务按成功调用计费,不按 Token 计费;失败或取消的任务会自动退款。

每次成功调用

$0.05每次调用

更多 Google 图像模型

常见问题

如何在 OmniaKey 上调用 Nano Banana 2 (Preview)?

向 /v1/media/tasks 发送 POST,带上模型 ID、type 设为 "image"、operation 设为 "generate" 或 "edit"。重试时复用同一个 Idempotency-Key,超时就不会再生成第二笔付费任务。

Nano Banana 2 (Preview) 如何收费?

Nano Banana 2 (Preview) 按 $0.05 每次调用 计费。创建时会从预付余额中预扣该金额,失败或取消的任务会自动退款。

为什么接口返回任务 ID 而不是图片?

供应商耗时从几秒到约一分钟不等,OmniaKey 因此把所有图像路由统一为同一套异步流程。轮询 GET /v1/media/tasks/{id},直到状态变为 succeeded,再读取签名后的资源地址。

Nano Banana 2 (Preview) API — 异步图像生成 · OmniaKey