Nano Banana Pro API 调用指南

先说结论:Pro 是什么,什么时候该用

Nano Banana Pro 是 Google Nano Banana 图像家族里的顶配成员,Google 明确把它定位在最复杂的视觉任务上:最高级别的世界知识、进阶本地化、精确的品牌一致性、精细的创作控制。它对应 Gemini 3 Pro Image,自 2026 年 2 月 Nano Banana 2 发布后,Pro 就作为家族质量天花板存在。 一句话路由规则:默认走 nano-banana-2,只有当输出本身就是产品的时候才升级到 nano-banana-pro——带品牌的营销素材、每个标签都必须准确的信息图、需要干净排版的多语言文案。日常草图、批量生成、普通插画,万金油款更快也更省。

Pro 比基础款多了什么,逐条对照 Google 文档

有两点需要提前接受:第一,Pro 比基础款慢,复杂 prompt 会进一步拉长耗时,把它当成秒级模型来规划体验预期,不要假设固定的响应时间;第二,以上能力定位来自 Google 官方文档,自己的场景到底值不值得升级,最快的验证方式就是同一句 prompt 分别在两个 ID 上跑一遍。

• 本地化级文字渲染:Google 把进阶文字渲染和本地化列为 Pro 的核心强项,基础款能渲染清晰短文字,Pro 面向密集、多语言、排版敏感的场景,比如信息图、海报、包装文案
• 品牌与角色一致性:支持参考图输入,最多约 14 张,用来在多次生成之间稳定同一个主体或身份
• 世界知识与推理:作为 Gemini 3 Pro 的衍生模型,家族里事实类知识最强,体现在描绘真实事物、地图、图表、历史细节时更靠谱
• 精细控制:面向需要刻意摆放元素、指定光线方向、指定镜头几何关系的构图任务
• 分辨率覆盖 1K、2K、4K;512px 的效率档只在 nano-banana-2 上

调用方式:先草稿后升级

Pro 走的是标准 OpenAI 图像生成写法:model 填 nano-banana-pro,配 prompt 和 size。返回结果在 data[0] 里,base64 或 URL 两种都要处理。编辑走图像编辑接口,同样带输入图。 因为 Pro 是家族里最贵的一档,值得固定下来的模式是先用 nano-banana-2 起草,确认 prompt 没问题后原样搬到 nano-banana-pro 上出最终分辨率的图,prompt 基本不用改,只换模型字符串和 size。

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的kkaiapi密钥",
    base_url="https://api.kkaiapi.com/v1",
)

prompt = (
    "会议海报,标题《2026 发布周》粗体紧凑字体,"
    "三个带标签的日程模块,瑞士网格排版,米白纸张底色,单一强调色"
)

# 先在万金油款上起草
draft = client.images.generate(model="nano-banana-2", prompt=prompt, size="1024x1024")

# 确认后在 Pro 上出最终分辨率
final = client.images.generate(model="nano-banana-pro", prompt=prompt, size="2048x2048")

Prompt 怎么写才配得上 Pro 的控制力

Pro 比家族里任何模型都更吃 prompt 的具体程度。基础款会用合理的默认值填补空白,Pro 是照你说的做,所以值得把排版体系、字体风格、光线、镜头角度、要渲染的具体文字和位置都写清楚——一条给 Pro 的 prompt 应该读起来像创作简报,而不是一句愿望。 图内文字的可靠写法是把每个字符串加引号并说明它的角色:标题、标签、说明文字。Pro 的本地化优势意味着翻译类需求是一等公民,比如同一张海报换成日文标题,这对多数图像模型都是硬骨头,恰恰是升级到这一档的理由。 品牌类工作则把约束写进文字里:准确的颜色描述、logo 位置、不能改动的部分。一致性是 Pro 的能力,不是保证,文字约束就是它锚定的依据。

什么场景值得直接从 Pro 起步

共同点是这些场景里会有人仔细端详这张图,或者图里承载了必须准确的文字与身份。两者都不占的场景,基础款的速度和价格更划算。

• 信息图和数据可视化:标签多、文字密集、内容涉及事实,同时吃文字渲染和世界知识两项能力
• 品牌素材生成:一系列campaign图必须保持同一个 logo、色板、产品身份
• 本地化营销素材:同一份创意翻译成多语言,标题要排版干净
• 印刷与 4K 交付物:海报、包装样机,任何在高分辨率下出图、瑕疵会被看见的场景
• 需要精确构图的合成场景:多元素刻意摆放、指定镜头和光线,"差不多"不够用

价格与人民币按张计价

Google 官方 Gemini API 按美元计价,公开资料显示 1K/2K 约 $0.134/张,4K 约 $0.24/张,这里只作参考。kkaiapi 按次计价,人民币,充多少花多少。

验证接入与排查首次调用

先拿自己的 Key 查一次 /v1/models,确认 nano-banana-pro 在返回列表里。首次请求报模型不存在,基本都是 ID 打错了,以列表里的拼写为准。 延迟在这一档表现不同:复杂的 Pro 生成可能跑到几十秒,客户端超时建议设到 60 秒起步,不要按简单请求的经验去判断这是卡住了。

curl -s https://api.kkaiapi.com/v1/models \
  -H "Authorization: Bearer sk-你的kkaiapi密钥" | grep banana

curl -s https://api.kkaiapi.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的kkaiapi密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-pro","prompt":"极简信息图,三个步骤,标注箭头","size":"1024x1024"}' \
  --max-time 90

常见问题