模型对比
各模型页生成示例的实际输出(Nano Banana 2.1 与 2 使用同一提示词):

Nano Banana 2.1,2K

Nano Banana 2,2K,同一提示词

Nano Banana Pro,4K

Nano Banana 2 Lite,1K
价格来自 2026 年 10 月 7 日公开价格配置,调用前请在模型与价格确认最新单价。
- Standard 是系列中最早的 Nano Banana(
gemini-2.5-flash-image),本站这样标注,以便与系列名区分。 - 五个模型都可以用 OpenAI 兼容格式或 Gemini 原生格式调用,区别见两种调用方式。需要指定比例或 2K、4K 分辨率时,使用 Gemini 原生格式。
- 比例和分辨率通过 Gemini 原生格式的
aspectRatio、imageSize设置,具体取值见各模型页。Standard 只输出约 1K,不能传imageSize。OpenAI 兼容格式下文生图输出 1K:Nano Banana 2.1 的画幅由模型按内容决定,其他模型为 1:1 的 1024×1024。 - 参考图数量来自 Google 图像生成文档:Standard 在输入不超过 3 张图时效果最好;Nano Banana 2 Lite 不针对多参考图和多轮连续编辑优化。
- 编辑图片的完整说明见 Nano Banana 图片编辑 API(Standard)和 Nano Banana Pro 图片编辑 API;Nano Banana 2.1、2 与 2 Lite 的编辑示例在各自的模型页。
- 新项目一般从 Nano Banana 2.1 开始,只要 1K 小图时选 Nano Banana 2 Lite。
- Google 对
gemini-2.5-flash-image停止日期的说法不一致:Google 弃用页截至 2026 年 10 月 8 日列为 2027 年 3 月 15 日,价格页仍保留 2026 年 10 月 2 日停止的旧提示。截至 2026 年 10 月 5 日老张API仍可调用该模型、价格不变,但不保证继续提供的期限。已接入 Standard 的项目请尽快迁移,改法见 Standard 图片编辑中的迁移说明。
- 模型来自 Google 官方渠道,不需要 Google 账号,只用老张API密钥。
- 按次线路以固定单价计费,分辨率、思考级别、参考图数量和生成 / 编辑都不改变单价,所以 2K、4K 出图低于 Google 按 token 计费的价格。
- 每次请求一张图,多张分多次请求。
- 平台不限制并发、不限速,
429来自上游容量,见并发与 429。 - 上游返回非 200(400、429、5xx)不扣费,HTTP 200 无图也扣一次,三个家族的对照见扣费与失败规则。
两种调用方式
两种格式使用同一个老张API密钥,主机都是https://api.laozhang.ai:
OpenAI 兼容格式适合已经使用 OpenAI SDK 的项目:
- 把 SDK 的
base_url设为https://api.laozhang.ai/v1,model换成 Nano Banana 模型 ID。 - 图片以 data URL(
data:image/png;base64,...)的形式出现在返回的message.content中,前后可能带有 Markdown 图片语法等文字。 - 解析时直接查找 data URL,并按其中的类型保存为 PNG、JPEG 或 WebP 文件。
parts 中也可能有文字块;逐个检查内容块,按 inlineData.mimeType 解码保存图片。
imageSize 使用大写 K,例如 2K;部分模型会拒绝小写的 2k。
两种格式都推荐使用 Authorization: Bearer $LAOZHANG_API_KEY 请求头。不要把密钥写进 URL 查询参数(例如 ?key=),URL 容易被日志、代理和浏览器历史记录下来。
计费规则
老张API的 Nano Banana 只提供按次计费:每个模型一个单价,不随输出分辨率、思考级别、参考图数量或生成 / 编辑而变化。唯一的额外费用是 Google 搜索接地,按检索次数另计,见下文。 Google 官方按 tokens 计费,输出分辨率越高、思考 tokens 越多,费用越高。下表对比 2026 年 10 月 7 日老张API公开价格配置与 Google 官方价格:
Google 官方价格取付费层级的标准档(Standard),按每张输出图片折算,官方另按输入与思考 tokens 计费;核对日期 2026 年 10 月 13 日。
在 Google 官方计费下,4K 输出和
high 思考级别都会提高单次成本,在老张API仍是同一个按次价格:分辨率越高,按次单价的优势越大,例如 Nano Banana 2 出 4K 图,比官方标准价低约 64%。
在令牌管理新建或编辑令牌时,计费模式选择「按量优先」(推荐)或「按次计费」,然后保存。按量优先的令牌可以同时调用按量和按次计费的模型,按次计费的令牌只能调用按次计费的模型;各计费模式的区别见计费与价格。

- HTTP 200 但没有图片:按一次调用扣费。 上游返回 HTTP 200 即视为调用完成,生成和编辑都一样。老张API不审查请求和生成内容,不按是否返回图片区分计费。原因与避免方法见避免没有图片的扣费。
- 客户端超时:服务端可能已经生成完成并计费。重试前先在调用日志中确认请求状态,避免重复生成、重复扣费。
- 上游返回非 200:400、429、503 等没有进入生成的请求不扣费。
- Google 搜索接地:每次检索另收 $0.014。 开启
googleSearch的请求,在按次单价之外按实际检索次数计费,单价与 Google 官方每 1000 次 $14 相同,适用于 Nano Banana 2.1、2 和 Pro。- 检索几次由模型决定,同样的提示词每次也可能不同;调用日志会写明本次的检索次数和费用。
- 例如 Nano Banana 2.1 一次请求检索 2 次,共扣 $0.045 + 2 × $0.014 = $0.073。
避免没有图片的扣费
HTTP 200 但没有图片,常见原因有两种:- 提示词没有要求出图:提示词只描述了需求,没有写明「生成一张图片」或「返回修改后的图片」,模型可能只做推理,最后只返回文字或空结果。
- 内容触发上游安全策略:提示词或参考图涉及版权 IP、敏感人物或敏感内容,Google 不生成图片,也不返回错误码。同样的内容原样重试,通常仍会被拦截,每次都会扣费。
- 色情、暴力、血腥或仇恨内容,包括暗示性的擦边内容;
- 去除图片上的水印;
- 迪士尼、漫威、任天堂等知名版权角色;
- 涉及未成年人的不当内容;
- 明星、政治人物等公众人物;
- 修改订单截图、票据、价格标签等金融信息;
- 给真人换装或换脸。
- 在提示词中明确要求生成或修改图片。
- 提交前自行检查提示词和参考图,去掉可能触发安全策略的内容。
- 响应中没有
candidates,或parts中没有inlineData,都当作没有出图;有返回结果时,读取finishReason和返回的文字判断原因。 - 不要自动重试没有图片的响应,修改提示词或参考图后再提交。429、5xx 仍可按退避策略重试。
共用代码
先设置密钥并安装依赖:nano_banana.py,本页和各 Nano Banana 模型页的 Python 示例都会导入它:
post():发送带鉴权的请求read_image():读取本地图片save_images():把两种格式的响应保存为图片文件
python nano_banana.py response.json output,可以把 cURL 保存的响应解码为 output-1.png 等文件,扩展名随实际图片格式变化。没有图片时,脚本会显示错误或文字内容。
Standard(gemini-2.5-flash-image)
这是 Nano Banana 系列的第一个模型,本节供已接入的项目迁移前维护使用。gemini-2.5-flash-image 已被 Google 弃用:Google 弃用页现列的停止日期为 2027 年 3 月 15 日,价格页仍写 2026 年 10 月 2 日。截至 2026 年 10 月 5 日老张API仍可调用,但随时可能停止。
下面的示例使用 OpenAI 兼容格式,文生图输出 1024×1024,并导入共用代码中的 nano_banana.py。
生成图片
在提示词中明确要求生成图片,并描述主体、场景和风格:- cURL
- Python
standard-generate-1.png 等文件。使用 OpenAI SDK 时:
- 调用
client.chat.completions.create(),传入相同的model和messages。 - 把
response.model_dump()传给save_images()。
编辑图片
把编辑指令和图片放在同一条 user 消息中,本地图片先转成 data URL。下面编辑上一步生成的图片(文件名以实际保存的为准):standard-edit-1.png 等文件。cURL 写法、多图合成、公网图片 URL 输入,以及把编辑请求迁移到 Nano Banana 2 的改法,见 Nano Banana 图片编辑 API(Standard)。
传入大图与图片 URL
整个请求体(包括 Base64 编码后的图片)不要超过 20MB;更大的参考图用fileData 传图片 URL。 图片转成 Base64 后体积增加约三分之一,所以用 inlineData 传的原图合计约 15MB 以内。
Gemini 原生格式中,fileData 和 inlineData 可以放在同一个 parts 里,按顺序作为第一张、第二张参考图。下面的请求体用 URL 传人物照片,用 Base64 传外套图片:
- HTTPS 直链,不需要登录、Cookie 或 Referer,没有验证码、Cloudflare 验证或 User-Agent 检测。
- 站点的
robots.txt没有禁止抓取图片所在路径。 - 签名链接的有效期覆盖排队和重试,建议至少 30 分钟。
mimeType与图片实际格式一致:JPEG 写image/jpeg,PNG 写image/png,WebP 写image/webp。
Cannot fetch content from the provided URL,这类请求不扣费。OpenAI 兼容格式同样可以在 image_url.url 里填公网图片 URL,要求相同。
请求失败或没有图片
常见问题
不用 Google 账号能调用 Nano Banana 吗?
可以。只需要老张API密钥,不需要 Google Cloud 项目、Gemini API Key 或 Google 账号。五个模型都来自 Google 官方渠道,请求格式与 Google 原生接口一致,按次计费。Nano Banana 的 API Key 怎么获取?
在老张API注册后,到令牌管理创建令牌:分组选default,计费模式选「按量优先」(推荐)或「按次计费」,保存后得到的 sk- 开头字符串就是调用五个 Nano Banana 模型的 API Key。不需要 Google 账号或 Gemini API Key;充值后即可按共用代码发送第一个请求,每次扣费在调用日志查看。
新项目该选哪个 Nano Banana 模型?
先用 Nano Banana 2.1(gemini-nano-banana-2.1)。它是 Nano Banana 2 的更新版,支持 1K–4K 输出、14 种比例和最多 14 张参考图,文字排版更准,单价也更低。其他情况:
- 需要 0.5K 预览图:选 Nano Banana 2。
- 只需要 1K、更看重单价和速度:选 Nano Banana 2 Lite。
- 复杂构图、精确文字渲染或品牌细节要求高:选 Nano Banana Pro。
- 不要在 Standard(
gemini-2.5-flash-image)上开始新项目:Google 已弃用该模型,停止日期的说法前后不一(弃用页为 2027 年 3 月 15 日,价格页仍写 2026 年 10 月 2 日),老张API暂时仍可调用,但随时可能停止。
OpenAI 兼容格式能出 16:9 或 4K 吗?
不能。OpenAI 兼容格式没有比例和分辨率参数。 需要 16:9、9:16 等比例时,用 Gemini 原生格式调用 Nano Banana 2 Lite、2.1、2 或 Pro;需要 2K、4K 时,选择 Nano Banana 2.1、2 或 Pro。分辨率、参考图数量或编辑会影响单价吗?
不会。每个模型只有一个按次单价,同一个模型输出 0.5K 还是 4K、思考级别用默认还是high、带 1 张还是 14 张参考图、生成还是编辑,每次调用的价格都相同。只有开启搜索接地时,会按检索次数每次另收 $0.014。与 Google 官方价格的对比见计费规则。
请求失败、超时或没有出图,会扣费吗?
HTTP 200 但没有图片会按一次调用扣费,包括提示词没有要求出图、内容被上游安全策略拦截的情况。客户端超时也可能已经扣费;上游返回非 200(如 429、503)的请求不扣费。 每次调用的状态和扣费见调用日志,各情况的处理方法见计费规则。一次请求能生成多张图吗?
不要依赖这种用法。Google 说明,模型不一定按提示词要求的数量输出图片。需要多张图时,分别发送多次请求,每次调用单独计费。 反过来,一个响应里偶尔会出现多张图片:Gemini 3 图像模型在思考时会生成临时图片检验构图,这些图片可能和最终结果一起返回,其中最后一张是最终结果。 共用代码中的save_images() 按顺序保存全部图片,编号最大的文件就是最后一张。
可以直接用中文提示词吗?
可以。Google 列出的最佳表现语言包括英语、简体中文(zh-CN)、日语、韩语等 15 种语言区域,本站示例也使用中文提示词。其他语言也能使用,但效果可能不够稳定。生成的图片带水印吗?
带。Google 说明,所有 Nano Banana 模型生成的图片都带有 SynthID 数字水印。SynthID 直接嵌入图片,人眼无法察觉,用于识别 AI 生成的内容。支持哪些输入图片格式?
Google 列出的图片输入格式为 PNG、JPEG、WebP、HEIC 和 HEIF。本站示例和共用代码中的read_image() 只处理 PNG、JPEG 和 WebP,HEIC、HEIF 照片可以先转成 JPEG。
无论哪种格式,mimeType 或 data URL 前缀都要与文件的实际格式一致。图片转成 Base64 后体积会增加约三分之一,很大的照片先缩小再上传,可以缩短请求时间。整个请求体超过 20MB 时,改用图片 URL,见传入大图与图片 URL。
纯白背景出现黑点或脏块怎么办?
把提示词里的纯白背景换成其他浅色背景。Nano Banana 走 Google AI Studio 线路,出纯白背景图时,大面积白色区域偶尔会出现黑点、脏块、灰白雾化或偏色,高峰时段更常见。可以改成:- 浅灰:
light gray background, #F5F5F5 - 米色:
beige background, #F5F0E5 - 淡蓝:
light blue background, #E8F0F8
相关文档
- Nano Banana 图片编辑 API(Standard):
gemini-2.5-flash-image的编辑写法与迁移 - Nano Banana 2 Lite API:1K 生成与编辑、10 种比例
- Nano Banana 2.1 API:1K–4K、14 种比例、三档思考级别
- Nano Banana 2 API:0.5K–4K、14 种比例
- Nano Banana Pro API:1K–4K 生成与搜索接地
- Nano Banana Pro 图片编辑 API:多图合成、公网 URL 输入与 4K 编辑
- 图像 API 选型与价格:与其他图像模型比较
- Gemini 协议:原生请求结构与 Google Gen AI SDK 配置
- 模型与价格:当前模型 ID 与单价
- Google 图像生成文档:模型能力、比例、参考图上限、支持语言与 SynthID 水印
- Google 图像理解文档:支持的输入图片格式
- Google Gemini API 价格:各图像模型的官方价格与搜索接地计费方式
- Google generateContent 参考:
imageConfig等字段定义