全部模型
Google · 媒体 API
Nano Banana 2 (Preview) API
Nano Banana 2(Preview)是 Google Gemini 3.1 Flash 图像路由的预览快照,通过预览模型 ID 提供相同的文生图与编辑能力。
- 模型 ID
- gemini-3.1-flash-image-preview
- 提供商
- 类型
- 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,再读取签名后的资源地址。
