REST 单一端点
所有生成与编辑任务都走 POST /api/generate，提交后返回 task_id，再轮询状态端点取回结果。请求参数用 JSON 传，响应结构固定，便于把调用逻辑写死在业务管线里。
官方说明 ↗
NanoBanana 2 API
AI TOOL PROFILE工具资料面向开发者的 RESTful AI 图像生成与编辑 API，支持最高 4K 分辨率输出。
价格按输出分辨率计费：1K 10 credits、2K 16 credits、4K 24 credits；含免费额度。
平台Web / API
归类AI 编程
收录2026-10-11
复核2026-10-11
编辑评分
4.1 / 5
★★★★☆
NanoBanana 2 API编辑总结
NanoBanana 2 API 是一套面向开发者的 RESTful 接口，用于调用 Banana 2 模型把文字提示词生成图像，或对已有图片做编辑，单个 HTTP 请求即可提交任务，通过 task_id 轮询取回结果。计费按输出分辨率走：1K 扣 10 credits、2K 扣 16 credits、4K 扣 24 credits，文本生成和图像编辑同价；生成通常在 10 秒以内完成，并支持 512×512 到 4K 的输出范围与最多 20,000 字符的提示词。新账号自带免费额度，不用绑信用卡即可开始。短板是官网没有公开各订阅档的具体价格与额度对应关系，也没有给出并发或地域限制的说明，重度用量前需要自行确认。
NanoBanana 2 API是什么？
NanoBanana 2 API 是一个图像生成的 RESTful 接口服务，开发者通过标准 HTTP 请求调用 Banana 2 模型，用文字提示词生成图片，或对已有图片做编辑。它面向的是要把图像能力接入自家产品的工程团队——SaaS、电商、营销自动化和游戏工作室这几类场景在官网被点名为典型用法。官方文档明确标注「Not affiliated with Google」，即与 Google 没有关联。
能力形态上，它围绕一个 POST /api/generate 端点展开：提交提示词或图片地址后返回 task_id，再轮询状态端点取回结果。分辨率支持 512×512 到 4K，可选 1k、2k、4k 三档；宽高比覆盖 1:1 到 21:9 等十余种预设并支持 auto；输出格式为 png 或 jpeg。认证采用 Bearer Token，具备 HTTPS 加密、速率限制与 GDPR 合规的数据处理。
使用路径上，开发者注册后从后台获取 API key，先在免费额度内跑通一条 cURL 或 Python、Node.js 请求，再把端点包进自己的业务流程；需要事实性补充时，可打开 google_search 参数引入第三方检索做依据。整个接入过程不依赖前端界面，适合放进已有的自动化管线。
NanoBanana 2 API核心功能
分辨率三档计费
输出可选 1k、2k、4k 三档，分别扣 10、16、24 credits，默认 1k。文本生成图像与图像编辑任务使用同一套计费标准，不因任务类型加价。
官方说明 ↗图像编辑
type 设为 edit 并传入 images 数组即可对已有图片改写，最多支持 14 张图，例如把猫改成老虎同时保留背景。传了 images 时类型会自动识别为 edit。
官方说明 ↗宽高比与格式
支持 1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9 及 auto，默认 1:1；输出格式可在 png 与 jpeg 间选，默认 png。
官方说明 ↗长提示词
prompt 字段上限 20000 字符，写复杂场景描述、风格约束和多段指令时不必反复精简，适合把较长的产品文案或镜头脚本直接当作输入。
官方说明 ↗事实检索开关
google_search 参数可取布尔值，默认关闭，开启后引入第三方搜索做事实依据，用于需要贴近真实世界信息的画面生成。
官方说明 ↗自动伸缩
基础设施可自动伸缩，从原型阶段到生产环境都能承接，官方表述为可处理数千并发请求而不必处理配额问题。
官方说明 ↗NanoBanana 2 API值不值得用？
当你要把图像生成接进已有系统、且希望计费可预估时，NanoBanana 2 API 的按分辨率扣费结构是清晰的——1K 10 credits、2K 16 credits、4K 24 credits，文本生成与编辑同价，免费额度足够先跑通链路。它的弱点也直白：官网没有公开各订阅档的价格与 credits 的完整对应，也没有说明并发上限和地域可用范围，团队要在正式放量前自行确认这两点。如果你的场景是批量出电商图或营销素材，先算清单张成本再决定档位；如果只是偶尔手工出图，网页端产品可能更省事。
建议选它的情况
- 需要把图像生成嵌进自家 SaaS、电商或营销管线的开发团队
- 希望按输出分辨率精确预估单张成本、不接受订阅包月的项目
- 要批量处理图片编辑任务，例如一次传入最多 14 张图的改写流程
不建议选它的情况
- 只偶尔手工出图、不打算写代码的轻度用户
- 对并发上限与地域可用性有硬性合规要求、需要先看到书面说明的团队
NanoBanana 2 API使用建议
入门先把路子走对
- 先跑 cURL 示例注册后从后台取出 API key，直接复制文档里的 curl 命令发一次请求，确认能拿到 task_id 再写业务代码，可以省掉排查鉴权的时间。
- 鉴权放 Header密钥以 Bearer Token 形式放在 Authorization 头里，格式是 Bearer sk-your-api-key-here，不要把密钥写进前端代码或公开仓库。
- 用轮询取结果提交后拿到的是 task_id 而不是图片本身，需要再请求状态端点确认完成，再下载或转交给下游处理。
进阶省时间也省钱
- 按用途选分辨率1K 扣 10 credits、2K 扣 16 credits、4K 扣 24 credits，草稿和预览用 1K，只有最终交付物才升到 4K，能显著压低批量成本。
- 编辑别重复生成已有底图时走 edit 类型并传入 images 数组，比重新生成一张更贴近原始素材，也避免风格漂移。
- 宽高比先定aspect_ratio 支持从 1:1 到 21:9 的多种预设，投放渠道的版式先在请求里定好，可以少一轮裁剪返工。
- 善用自动识别请求里带 images 时 type 会自动判定为 edit，不带则默认 text-to-image，正常流程里不必手动指定该字段。
NanoBanana 2 API适合谁用？
SaaS 产品团队
推荐把图像生成嵌进自家产品、让用户在应用内直接出图，走单一端点即可接入，不必自建推理设施。
电商运营与卖家
推荐批量产出商品图、场景图和营销视觉，可把制作成本降低 90%，适合按分辨率精算单张费用的团队。
营销自动化团队
推荐把社媒素材、广告横幅和邮件配图接进营销管线自动生成，需要管线本身已支持调用外部 HTTP 接口。
游戏美术与原型
推荐程序化产出概念图、贴图、角色立绘和环境素材，适合在早期探索阶段快速铺量。
只想手工出图的个人
不推荐如果不需要写代码调用，纯图形界面产品在操作上更直接，接口方案的优势发挥不出来。
NanoBanana 2 API优点和缺点
优点
- 单张成本可直接折算：1K 10 credits、2K 16 credits、4K 24 credits
- 文本生成与图像编辑同价，不改任务类型不额外加价
- 提示词上限 20000 字符，长描述不用反复精简
- 图像编辑单次最多传 14 张图，批量素材可一次处理
- 生成速度官方标称在 10 秒以内
- 新账号含免费额度，不用信用卡即可开始
缺点
- 应关系
- 官网未说明并发上限与地域可用范围
- 输出只支持 png 与 jpeg 两种格式
- 与 Google 无关联，品牌易被误认
NanoBanana 2 API常见问题
NanoBanana 2 API 怎么收费？＋
按输出分辨率扣 credits：1K 扣 10 credits、2K 扣 16 credits、4K 扣 24 credits，默认按 1K 计费。文本生成图像和图像编辑任务使用同一套标准，不因任务类型不同而变价。
有免费额度吗，要不要绑卡？＋
有。新账号自带免费额度，无需信用卡即可开始生成图像。免费额度能跑通接入流程和做初步验证，超出后需要转到付费方案。
生成一张图要多久？＋
官方给出的典型值是在 10 秒以内。实际耗时与所选分辨率和画面复杂度有关，分辨率越高、提示词越复杂，耗时通常越长。
支持哪些分辨率和宽高比？＋
分辨率覆盖 512×512 到 4K，请求时可在 1k、2k、4k 三档中选择。
能不能直接改已有图片？＋
可以。把 type 设为 edit 并传入 images 数组即可，最多支持 14 张图，例如把猫改成老虎同时保留原本背景。
提示词有长度限制吗？＋
prompt 字段上限为 20000 字符。写多段场景描述、镜头语言或较长的产品文案时，通常不需要为了长度而删减内容。
这是 Google 的产品吗？＋
不是。官方文档明确标注与 Google 没有关联。调用时用的是该服务自己签发的 API key，以 Bearer Token 形式放在 Authorization 头里。
NanoBanana 2 API竞品对比
| 工具 | 编辑评分 | 价格 | 核心功能 | 平台 |
|---|---|---|---|---|
| NanoBanana 2 API本工具 | 4.1 | 按输出分辨率计费：1K 10 credits、2K 16 credits、4K 24 credits；含免费额度。 | REST 单一端点；分辨率三档计费；图像编辑；宽高比与格式 | Web / API |
| GenPen AI | — | 未标价 | AI 驱动的平台，快速生成 REST API 和软件开发 | — |
| Nano Banana Pro API | — | $0.040/gen 起，4K 档 $0.070/gen | Google 的下一代 AI 图像生成器，具有4K 分辨率和先进功能 | Web / API |
| Google AI for Developers | — | 分免费、付费、企业三层，Flash 付费输入 0.75 美元/100 万 tok | 面向开发者的谷歌 AI | Web / API |
| Aspen | — | 未标价 | 免费的 macOS API 测试应用，具备 AI 集成，专注于 REST APIs 和数据安全 | — |
| Nano Banana AI | — | 未标价 | AI 驱动的图像生成与编辑工具，打造惊艳视觉 | — |
