Skip to main content
Nano Banana Pro Edit:专业 4K 图片编辑路线
  • 稳定模型 IDgemini-3-pro-image
  • 老张API价格:当前 $0.09/次,实际价格与扣费以控制台为准
  • 编辑能力:局部修改、风格迁移、多图融合、文字重绘和复杂构图
  • 生产接入:OpenAI 兼容格式与 Gemini 原生格式

控制台入口

创建 API Key,查看余额和调用日志

🚀 在线测试

影图 AI 即刻体验,无需写代码
查看 图像生成 API 选型指南 比较全部型号。老张API提供统一全球 HTTPS 入口和调用日志,网关不设置固定低并发套餐档位;实际吞吐仍受 Google 上游容量、账号状态与安全策略影响。

前置要求

1

获取 API Key

登录 laozhang.ai 控制台 获取 API 密钥
2

配置计费模式

编辑令牌设置,选择以下任一计费模式(两者价格相同):
  • 按量优先(推荐):优先使用余额计费,余额不足时自动切换
  • 按次计费:每次调用直接扣费。适合预算控制严格的场景
两种模式价格完全相同,都是 $0.09/次,仅扣费方式不同。
令牌设置
如果未设置计费模式,API调用会失败。必须先完成此配置!

模型简介

Nano Banana Pro 编辑 (gemini-3-pro-image) 专为需要精准控制和高质量输出的场景设计。不同于简单的滤镜或修补,它能理解复杂的自然语言指令,对画面进行逻辑性的修改。

核心能力

  • 精准局部修改: “把那只猫换成一只戴眼镜的狗,但保持姿势不变”
  • 风格完美迁移: “把这张照片变成赛博朋克风格的油画,光线要更加强烈”
  • 多图创意融合: “结合这两张图,生成一张全新的海报”
  • 4K 高清输出: 支持输出 2K/4K 分辨率的编辑结果

🌟 核心特性

  • ⚡ 极速响应:平均 10 秒完成编辑
  • 💰 价格以控制台为准:$0.09/次,实际扣费以控制台记录为准
  • 🔄 双重兼容:支持 OpenAI SDK 和 Google 原生格式
  • 📐 灵活尺寸:Google 原生格式支持 14 种纵横比
  • 🖼️ 高分辨率:支持 1K、2K、4K 三种分辨率输出
  • 🧠 思考模式:内置推理能力,理解复杂编辑指令
  • 🌐 搜索接地:支持结合实时搜索数据进行编辑
  • 🎨 多图参考:支持最多 14 张参考图片进行复杂合成
  • 📦 Base64 输出:直接返回 base64 编码图片数据
  • 🔗 URL 直传:Google 原生格式支持直接传入图片 URL(需海外可访问),无需 Base64 编码

🔀 两种调用方式

💡 如何选择?
  • 如果价格要默认比例的图片,使用 OpenAI 兼容模式,简单快捷
  • 如果需要自定义纵横比(如 16:9、9:16)或高分辨率(2K/4K),使用 Google 原生格式

📋 模型对比

与其他编辑模型对比

Pro / Banana 2 / Standard 详细对比

💰 价格说明
  • Nano Banana Pro:老张API当前 $0.09/次;Google Standard 当前为 $0.134(1K/2K)或 $0.24(4K)
  • 价格透明:按次计费,实际扣费可在调用日志中查看

🚀 快速开始

准备工作

1

创建令牌

登录 老张API令牌管理 创建按次计费类型的令牌令牌创建界面
2

选择计费方式

重要:必须选择”按次计费”类型
3

保存令牌

复制生成的令牌,格式为 sk-xxxxxx

方式一:OpenAI 兼容模式

单图编辑 - Curl

单图编辑 - Python SDK

多图合成 - Python SDK

方式二:Google 原生格式(支持自定义纵横比 + 4K)

认证方式

Google 原生格式支持三种认证方式:
💡 三种方式效果相同,选择你喜欢的即可。

支持的分辨率

💡 分辨率设置方法generationConfig.imageConfig.imageSize 中传入 "2K""4K"。不传则默认为 "1K"

图片输入方式

Google 原生格式支持两种图片输入方式:
💡 两种方式对比
  • inline_data:传入 Base64 编码数据,适合本地图片
  • fileData:直接传入图片 URL,更简洁(推荐在线图片使用)
⚠️ URL 方式限制 使用 fileData.fileUri 传入图片 URL 时,需要满足以下条件:
  • 图片 URL 必须是海外公网可直接访问的地址
  • 图片服务器不能有反爬机制(如 Cloudflare 验证、验证码、User-Agent 检测等)
  • 访问受限的图片,请使用 inline_data 方式(先下载再转 Base64)

4K 高清编辑 - Curl(Base64 方式)

4K 高清编辑 - Curl(URL 方式)

使用 fileData.fileUri 直接传入在线图片 URL,无需转换为 Base64:
💡 URL 方式要点
  • 使用 fileData.fileUri 替代 inline_data.data
  • 需要指定 mimeType(如 image/pngimage/jpeg
  • 可选添加 role: "user" 明确角色
  • 图片 URL 必须是海外公网可直接访问的地址

Python 代码示例

💡 三个示例递进关系 示例1编辑图片 → 示例2用它变换风格 → 示例3融合前两张图。逻辑清晰!

🎯 编辑场景示例

1. 单图编辑 - 添加元素

2. 风格转换

3. 多图合成

💡 最佳实践

编辑指令优化

多图处理策略

❓ 常见问题

Nano Banana Pro 和 Nano Banana 2 都支持 4K。本页使用 Pro 的 Google 原生格式并添加 imageSize 参数:
重要:必须使用大写 “K”(1K、2K、4K)。
支持常见的图片格式:
  • JPG/JPEG
  • PNG
  • WebP
  • GIF(静态)
建议使用 JPG 或 PNG 格式以获得最佳效果。
  • 推荐大小:单张图片 ≤ 5MB
  • 最大大小:≤ 10MB
  • 过大的图片会增加处理时间,建议压缩后上传
  • Nano Banana Pro:支持最多 14 张图片
  • Nano Banana:支持最多 3 张图片
  • 图片过多会影响生成质量和处理时间,建议 ≤ 4 张
实际价格和扣费以老张API控制台为准。
完美支持! Gemini 3 Pro 拥有顶级的多语言理解能力,您可以直接使用中文描述编辑需求。
  1. 详细描述:提供具体的编辑细节
  2. 分步骤:复杂编辑分多个步骤描述
  3. 参考风格:指定艺术风格
  4. 保持主体:明确说明需要保留的内容
Google 原生格式支持两种图片输入方式:1. URL 方式(fileData.fileUri - 更简洁
2. Base64 方式(inline_data - 更通用
⚠️ URL 方式限制:
  • 图片 URL 必须是海外公网可直接访问的地址
  • 图片服务器不能有反爬机制(Cloudflare 验证、验证码等)
  • 访问受限的图片,请使用 Base64 方式
推荐场景:
  • 图片托管在 AWS S3、Google Cloud Storage、Cloudinary 等 → 用 URL
  • 图片位于受限网络或有访问限制 → 用 Base64

🎯 常见用例

  1. 电商换模特: 上传衣服图和模特图,生成穿搭效果
  2. 装修设计: 上传毛坯房照片,通过 Prompt 生成装修后效果
  3. 游戏素材: 快速修改游戏图标或角色外观
  4. 社交媒体: 将人像照片转换为各种艺术风格
  5. 产品展示: 将产品放入不同场景背景中
  6. 创意海报: 融合多张素材生成海报设计

🔗 相关资源

Pro 图像生成

学习如何使用 Nano Banana Pro 从文字生成图片

Standard 图像编辑

可选的 Nano Banana Standard 编辑版本

令牌管理

创建和管理你的 API 令牌

价格说明

查看详细的价格表和计费说明

📝 更新日志

🔗 新增 fileData.fileUri 方式
  • 支持直接传入在线图片 URL,无需下载和 Base64 编码
  • 新增 Curl 和 Python 代码示例
  • 注意:图片 URL 需海外公网可访问且无反爬机制
  • 新增相关 FAQ 说明
🚀 Nano Banana Pro 编辑专属页面
  • 从混合文档拆分为独立的 Pro 版本文档
  • 完整的 4K 分辨率编辑指南
  • 详细的多图合成说明
  • 完整的代码示例和最佳实践
  • 与 Nano Banana Standard 的对比说明