从提示词生成画面
用主体、场景、光线、构图与风格描述所需图像。先用 1K 比较方向，再根据实际展示尺寸选择 2K 或 4K。
Overview
API
Pricing
Bring this model into your workflow
Submit requests to the public API at api.acedata.cloud using the documented parameters, then use the results in your application.
- API host
api.acedata.cloud- model
nano-banana-2.1
Input parameters and result formats vary by service. Use the public API for this model and follow its guide for generation, task retrieval and editing operations.
规格与接口特性
- 原生型号
- Gemini Nano Banana 2.1
- 输出分辨率
- 1K、2K、4K
- 创作方式
- 文本生成；参考图编辑
- 专用入口
- POST /nano-banana/images
- 图像结果
- data[].image_url
- 异步任务
- 支持 task_id 查询与回调
填写完整的 model=nano-banana-2.1；不带 :official 后缀。不同入口的请求和返回字段以各自 API 文档为准。
核心能力
基于参考图编辑
提供可访问的图片链接，并分别写清要改变和要保留的内容。编辑结果仍需检查关键物体、文字与品牌细节。
匹配交付画幅
可选择方形、横版或竖版比例；分辨率决定输出细节，画幅决定构图，两者可以分别指定。
适用场景
商品展示图
先生成或上传主体图，再指定桌面、室内或户外背景，比较多种展示方向。
文章与活动配图
按版位选择横向或竖向画幅，并为标题和界面元素预留空间。
素材修改
用图片编辑调整颜色、局部物体或视觉风格，保留原图中需要延续的结构。
如何选择
与 Nano Banana 2 比较
2.1 是后续型号，可作为新的高效创作起点。两者都支持高分辨率；已有固定工作流可用相同提示词分别验证效果。
与 Pro 比较
Pro 面向更复杂的视觉成稿。涉及严格品牌一致性、多元素排版或关键文字时，建议分别试图并人工审核结果。
开始使用
选择操作
从零创作用 action=generate；修改现有图片用 action=edit 并填写 image_urls。
指定型号和尺寸
填写 model=nano-banana-2.1、prompt，按需要设置 aspect_ratio 与 resolution=1K/2K/4K。
读取结果
同步请求读取 data[].image_url；异步请求保留 task_id，查询任务状态或接收回调。
示例任务
输入
生成奶白背景上的蓝色陶瓷花瓶，柔和侧光、干净留白、无文字；以 1:1 和 2K 输出。
检查
确认主体形状、背景色、阴影与最终像素尺寸。需要修改颜色时，把结果图作为下一轮编辑输入。
使用边界
- 图像中的文字、商标和细节需要人工审核；生成结果不能替代正式校对。
- 编辑可能重绘参考图的一部分。对必须保持不变的内容，应在提示词中明确说明并逐轮检查。
- 一次请求可生成多张图像，实际费用按成功张数和当前套餐价格计算；请以实时定价页为准。
常见问题
2.1 支持哪些分辨率？
支持 1K、2K、4K。先按用途选择尺寸，不必为概念草稿一开始就使用最高分辨率。
可以编辑已有图片吗？
可以。使用 action=edit、image_urls 和修改指令。
省略 model 会使用 2.1 吗？
不会。默认模型仍是 nano-banana，使用 2.1 时请显式填写完整 ID。
有 2.1:official 变体吗？
目前没有。请使用 nano-banana-2.1。
如何查看价格与结果？
价格随套餐变化，以实时定价页为准；同步结果在 data[].image_url，异步请求使用任务 ID 查询。
Use it in your favorite tools
Choose a development approach or application suited to this model and follow its setup guide.
↗Connect nano-banana-2.1 to Python SDK
Python SDK Integration Guide
SDK installation, authentication and examples↗Connect nano-banana-2.1 to TypeScript SDK
TypeScript SDK Integration Guide
SDK installation, authentication and examples
↗Claude Code with Nano Banana MCP
Service MCP setup · model options depend on the current tool list
↗Claude App with Nano Banana MCP
Service MCP setup · model options depend on the current tool list
↗Nano Banana Images API
API parameters and request examplesQuickstart
Try the API
API Key
Please obtain an API Key first
This is only a basic call example. See the full docs for more parameters and advanced usage.
View Docs