把文字简报转成视觉草案
用主体、环境、光线、构图和风格描述组织提示词，Lite 可用于探索同一创意的不同画面方向。它适合在设计前期验证视觉关系，例如比较产品居中与侧置、明亮与暗调背景，而不是一开始就把任务压在精细成品上。
Overview
API
Pricing
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 型号定位
- Google Gemini 3.1 轻量图像创作型号
- 输出分辨率
- 1K
- 创作模式
- generate 文生图；edit 图像编辑
- 参考方式
- 通过 image_urls 提交参考图片，配合文字编辑指令
- 画幅选择
- 1:1、3:2、2:3、16:9、9:16、4:3、3:4
- 结果交付
- 图像 URL、task_id 与 trace_id
- 任务处理
- 支持 async 与 callback_url
Lite 的创作定位为 1K 图像；画幅、任务处理与结果字段按本平台图像入口使用。
核心能力
了解 nano-banana-2-lite:official 能为你的工作带来什么。
围绕参考图片进行修改
编辑时提供原图，并在提示词中区分需要保留和需要改变的部分，例如保留杯子的外形与颜色，只替换桌面和背景。多图组合可以让主体、场景等素材共同参与创作；清楚说明每张参考图的用途，有助于减少元素混用。
适配不同展示版式
七种画幅覆盖方形素材、横向封面与竖向展示。选择比例时，应同时描述主体位置和留白方向，例如竖图中让人物偏下、顶部留出标题空间。这样是在生成阶段设计构图，而非把同一张图机械裁切成不同版式。
适用场景
从具体任务出发，找到模型发挥作用的位置。
商品场景试稿
输入产品参考图，描述木桌、窗边或简洁室内等场景，并要求保留产品轮廓与主色。交付物是用于讨论的场景候选图，便于团队比较背景、光线和摆放方式。涉及包装文字、接口位置等细节时，应对照实物逐项检查。
活动视觉方向探索
输入活动主题、品牌色和目标画幅，先生成不同构图的封面或海报底图，再围绕选中的方向调整氛围与元素。Lite 更适合产出视觉方案候选；正式标题、日期和规则文字可在排版阶段加入，避免让图像生成承担全部文字校对。
参考角色的连续编辑
以同一角色图片作为参考，分别描述背景、服装配色或画面风格的变化，制作贴纸、情绪图和内容配图草案。每轮都明确保留面部特征与关键标识，并检查结果是否偏离原设定；参考图能够辅助延续形象，但不等于锁定每处细节。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
先验证方向，选择 Lite
如果任务重点是找到合适的构图、配色和场景，且 1K 图像足以用于预览与讨论，可优先选择 Lite。它与 nano-banana-2 属于不同档位：Lite 强调轻量创作与快速验证，nano-banana-2 偏向均衡选择。应按交付要求决定，而不是把两个名称视为相同型号。
高分辨率成品，考虑 Pro
需要 2K 或 4K 交付、复杂细节展示或更精细的品牌视觉时，可考虑 nano-banana-pro。不要通过给 Lite 设置更高的 resolution 值来替代升级。更实用的流程是先用 Lite 验证方案，再把选定的构图要求和参考素材交给适合成品制作的型号。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- Lite 的输出定位是 1K，不适合作为高分辨率印刷、大幅展示或密集细节图的直接成品。即使后续放大，也不能据此保证恢复真实细节；交付尺寸要求较高时，应从创作阶段选择合适的型号。
- 图像编辑不是对原图像素的严格锁定。替换背景、服装或材质时，主体边缘、纹理和局部结构可能随之变化。对商品真实性要求较高的任务，应检查标志、配件数量、比例和关键形状，不能只看整体氛围。
- 调用时使用 model=nano-banana-2-lite:official，并明确 generate 或 edit；编辑还需提供参考图片及修改说明。结果以图像链接交付，不是可编辑图层文件，后续精确排版和局部修饰仍需配合图像工具完成。
常见问题
解答使用 nano-banana-2-lite:official 时的常见疑问。
nano-banana-2-lite:official 适合哪些任务？
它适合 1K 视觉草案、商品换景试稿、活动素材探索及参考图编辑。尤其适用于先比较多个创意方向、再确定成品方案的流程。如果任务主要考核印刷尺寸或极细纹理，应优先考虑更高分辨率的型号。
Lite 可以生成 2K 或 4K 图像吗？
Lite 按 1K 图像创作定位使用，不应把 2K 或 4K 当作它的可用输出档位。需要更高分辨率时，可选择支持相应尺寸的型号，例如 nano-banana-pro；仅修改请求中的分辨率值不能代替型号能力。
怎样用参考图修改背景而保留主体？
使用 edit 操作，将参考图片放入 image_urls，并在 prompt 中写清主体必须保留的特征与背景需要改变的内容。建议避免同时改动过多属性，先完成换景，再检查主体轮廓、颜色和细节是否发生了不希望的变化。
生成横图和竖图时只改比例就够了吗？
还应同步调整构图说明。横图可以强调左右留白和环境展开，竖图可强调主体上下位置及顶部空间。Lite 的入口提供七种比例，选择符合展示位置的画幅，再描述元素布局，比生成后裁切更有针对性。
怎样接入并获取生成结果？
向 /nano-banana/images 发送 POST 请求，指定该型号、action 和 prompt；编辑时补充 image_urls。响应提供任务标识及 data 中的 image_url，可用于展示或下载。需要异步处理时，可结合 async 和 callback_url 安排结果接收。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。
Top-up
You pay$13,584for 142,800 credits · $0.0951 / credits
You're billed in credits. Pick a top-up tier to see its per-credit rate — the larger the top-up, the cheaper each credit.
Quickstart
Try the API
API Key
Please obtain an API Key first
Your API key is pre-filled in the snippet — copy and run it in your terminal or IDE.
This is only a basic call example. See the full docs for more parameters and advanced usage.