Nano Banana Pro 开发指南

Nano Banana Pro 当前状态为“已上线”。本页提供开发接入所需的模型 ID、定价快照与可复制示例；产品介绍与实时价格见 Nano Banana Pro 模型页。

简介

• 供应商：Google
• 类型：图像生成
• 档位数：1
• 端点标签：image-task, openai

此图像模型使用异步任务接口：提交 `POST /v1/images/tasks` 后，通过 `GET /v1/tasks/{task_id}` 查询进度和结果。

Nano Banana Pro 是 Google DeepMind 于 2025 年 11 月 20 日发布的图像生成与编辑模型，官方模型名为 Gemini 3 Pro Image，构建在 Gemini 3 Pro 之上。官方资料强调三点：用推理能力处理复杂的多轮生成与编辑；可连接 Google Search 生成基于实时事实的信息图；在图内直接渲染多语言的清晰文字。官方 Vertex 规格还列出了最多 14 张参考图、最多 5 人的人物一致性和 1K/2K/4K 分辨率。

Roko 当前以 nano-banana-pro 接入，公开两条路线：文生图与图生图（image_urls 接受 URL 或 base64），宽高比 11 种（含 auto 默认），分辨率 1K/2K/4K，价格分别为每张 $0.018、$0.024、$0.036，批量 n 在单价上线性叠加。参考图数量上限以 Roko 请求校验为准；官方 14 张规格属于上游能力，本站未做验证，不写入页面承诺。

能力与效果类主张全部引用 Google 官方资料并标注来源；可调用参数与价格以 Roko 当前公开目录为准。Google 官方 API 的定价与本站不同，页面不引用也不换算。该模型的所有效果演示均以「非 Roko 实测」口径处理，案例基线见下文说明。

Google: Introducing Nano Banana Pro ↗Google Cloud: Gemini 3 Pro Image model card ↗Roko API 图片任务文档 ↗Roko API 模型目录 ↗

可用档位与价格

请求里的 model 必须使用下表中的模型 ID（区分大小写）。

价格为构建时快照；以控制台与 定价页 实时数据为准。

Base URL 与认证

export OPENAI_BASE_URL="https://api.rokoapi.com/v1"
export OPENAI_API_KEY="sk-..."

所有请求携带 Authorization: Bearer $OPENAI_API_KEY。密钥在 控制台密钥页 创建。

快速开始

cURL

curl https://api.rokoapi.com/v1/images/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "a calm lake at dawn, photorealistic",
    "size": "1:1",
    "quality": "1K"
  }'

Python（requests）

import requests

base_url = "https://api.rokoapi.com/v1"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID",
}
task = requests.post(
    f"{base_url}/images/tasks",
    headers=headers,
    json={
        "model": "nano-banana-pro",
        "prompt": "a calm lake at dawn, photorealistic",
        "size": "1:1",
        "quality": "1K",
    },
).json()
result = requests.get(
    f"{base_url}/tasks/{task['task_id']}",
    headers=headers,
).json()
print(result)

常用参数

提交成功会同时返回值相同的 id 和 task_id；新代码应保存 task_id。生产调用建议携带唯一的 Idempotency-Key。请定期请求 GET /v1/tasks/{task_id} ，直到状态变为 completed 或 failed；不要使用聊天或流式端点调用异步生成模型。 完整协议见图像生成任务。

注意事项

• 请使用本页列出的已上线模型 ID；未开通或已下线的名称会返回模型不可用类错误。
• 余额不足、分组无权限时通常表现为 403；请检查账户额度与密钥所属分组。
• 多模态、工具调用、缓存计费等能力因上游与渠道配置而异，以实际响应与控制台说明为准。
• Nano Banana 请求不要发送 n；不同画质可能采用不同价格，提交前请查看 实时定价。

相关链接

• Nano Banana Pro 模型落地页
• 快速开始
• 认证
• 图像生成任务
• 定价总览