跳转到主要内容
老张API提供 Google 当前的 Gemini 图像模型系列 Nano Banana 共五个模型,都按次计费,只需老张API密钥,不需要 Google 账号。本页帮你选模型和调用方式,并提供各模型页共用的请求与保存代码。

模型对比

各模型页生成示例的实际输出(Nano Banana 2.1 与 2 使用同一提示词):
Nano Banana 2.1 生成的雨后街角咖啡馆

Nano Banana 2.1,2K

Nano Banana 2 用同一提示词生成的雨后街角咖啡馆

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

Nano Banana Pro 生成的黄昏未来城市天际线

Nano Banana Pro,4K

Nano Banana 2 Lite 生成的深色物流仪表盘概念图

Nano Banana 2 Lite,1K

2026 年 10 月 14 日用同一提示词各生成一张 2K、16:9 的实测耗时:Nano Banana 2.1 24 秒、Nano Banana 2 22 秒、Nano Banana Pro 46 秒;并排样张见 Nano Banana 2.1 页。 分辨率、比例与参考图数量: 价格来自 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 文件。
Gemini 原生格式可以设置比例和分辨率,也适合沿用 Gemini 请求结构或 Google Gen AI SDK 的项目,SDK 配置见 Gemini 协议。响应中的图片结构如下:
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 不生成图片,也不返回错误码。同样的内容原样重试,通常仍会被拦截,每次都会扣费。
常会触发 Google 安全策略的内容:
  • 色情、暴力、血腥或仇恨内容,包括暗示性的擦边内容;
  • 去除图片上的水印;
  • 迪士尼、漫威、任天堂等知名版权角色;
  • 涉及未成年人的不当内容;
  • 明星、政治人物等公众人物;
  • 修改订单截图、票据、价格标签等金融信息;
  • 给真人换装或换脸。
Google 的过滤有一定随机性,同一提示词有时能出图、有时被拦截,规则也会随上游调整而变化。被拦截时返回的通常是一段拒绝说明文字,而不是错误码。 批量调用前,在客户端做好以下处理:
  1. 在提示词中明确要求生成或修改图片。
  2. 提交前自行检查提示词和参考图,去掉可能触发安全策略的内容。
  3. 响应中没有 candidates,或 parts 中没有 inlineData,都当作没有出图;有返回结果时,读取 finishReason 和返回的文字判断原因。
  4. 不要自动重试没有图片的响应,修改提示词或参考图后再提交。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。

生成图片

在提示词中明确要求生成图片,并描述主体、场景和风格:
成功后当前目录会出现 standard-generate-1.png 等文件。使用 OpenAI SDK 时:
  1. 调用 client.chat.completions.create(),传入相同的 model 和 messages。
  2. 把 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 传外套图片:
用 URL 传图时,请求体只有几百字节,几十 MB 的高分辨率照片也可以这样传。图片由服务端下载,URL 需要满足:
  • HTTPS 直链,不需要登录、Cookie 或 Referer,没有验证码、Cloudflare 验证或 User-Agent 检测。
  • 站点的 robots.txt 没有禁止抓取图片所在路径。
  • 签名链接的有效期覆盖排队和重试,建议至少 30 分钟。
  • mimeType 与图片实际格式一致:JPEG 写 image/jpeg,PNG 写 image/png,WebP 写 image/webp。
下载不到图片时返回 400,提示 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暂时仍可调用,但随时可能停止。
已接入 Standard 的项目,1K 单图编辑可以迁移到 Nano Banana 2 Lite,依赖多图合成的迁移到 Nano Banana 2.1 或 Nano Banana 2(两者请求写法相同),改法见 Standard 图片编辑中的迁移说明。

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
只改背景描述,不影响主体的颜色。确实需要纯白底时,可以在自己的后期处理中替换背景色。有瑕疵的图片同样按一次调用扣费,批量出图前先用几张样图确认效果。

相关文档