Generate visuals from prompts
Describe the desired image using subjects, scenes, lighting, composition, and style. Start with 1K to compare directions, then choose 2K or 4K based on the actual display size.
Overview
API
Pricing
nano-banana-2.1
Generate quickly, and fine-tune images with precision
Nano Banana 2.1 is suitable for creating images from text concepts, or progressively adjusting visuals with reference images and instructions. Choose 1K, 2K, or 4K resolution based on delivery needs, and complete both generation and editing in the same API.
GoogleModel brand
1K · 2K · 4KOutput resolution
Generation · EditingCreation methods
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.
Specifications and API Features
- Native model
- Gemini Nano Banana 2.1
- Output resolution
- 1K, 2K, 4K
- Creation methods
- Text generation; reference image editing
- Dedicated endpoint
- POST /nano-banana/images
- Image result
- data[].image_url
- Asynchronous tasks
- Supports task_id queries and callbacks
Specify the full model=nano-banana-2.1; without the :official suffix. Request and response fields vary by endpoint; refer to the respective API documentation.
Core Capabilities
Edit based on reference images
Provide accessible image links, and clearly specify what to change and what to preserve. Still inspect key objects, text, and brand details in the edited result.
Match the delivery aspect ratio
Choose square, landscape, or portrait proportions; resolution determines output detail, while aspect ratio determines composition, and they can be specified independently.
Use Cases
Product showcase images
First generate or upload a subject image, then specify a desktop, indoor, or outdoor background to compare multiple presentation directions.
Article and event visuals
Choose a landscape or portrait aspect ratio based on the placement, and reserve space for titles and interface elements.
Asset editing
Use image editing to adjust colors, local objects, or visual style while preserving structures from the original image that need to continue.
How to Choose
Compared with Nano Banana 2
2.1 is the successor model and can serve as a new efficient starting point for creation. Both support high resolution; existing fixed workflows can validate results separately using the same prompts.
Compared with Pro
Pro is designed for more complex finished visual work. For strict brand consistency, multi-element layouts, or critical text, it is recommended to try both separately and review the results manually.
Get Started
Choose an Action
For creating from scratch, use action=generate; to modify an existing image, use action=edit and provide image_urls.
Specify the Model and Size
Provide model=nano-banana-2.1 and prompt, and set aspect_ratio and resolution=1K/2K/4K as needed.
Read the Results
For synchronous requests, read data[].image_url; for asynchronous requests, retain the task_id to query task status or receive callbacks.
Example Task
Input
Generate a blue ceramic vase on an ivory background, with soft side lighting, clean negative space, and no text; output at 1:1 and 2K.
Check
Confirm the subject shape, background color, shadows, and final pixel dimensions. When changing colors, use the result image as the input for the next editing round.
Usage Limits
- Text, trademarks, and details in images require manual review; generated results cannot replace formal proofreading.
- Editing may redraw part of the reference image. For content that must remain unchanged, state it clearly in the prompt and check it after each round.
- A single request can generate multiple images. Actual charges are calculated based on the number of successful images and current plan pricing; refer to the live pricing page.
Frequently Asked Questions
What resolutions does 2.1 support?
It supports 1K, 2K, and 4K. Choose the size based on the intended use; there is no need to use the highest resolution from the start for concept drafts.
Can I edit existing images?
Yes. Use action=edit, image_urls, and modification instructions.
Will omitting model use 2.1?
No. The default model is still nano-banana; when using 2.1, explicitly provide the full ID.
Is there a 2.1:official variant?
Not currently. Please use nano-banana-2.1.
How do I view pricing and results?
Pricing varies by plan; refer to the live pricing page. Synchronous results are in data[].image_url, while asynchronous requests use the task ID for queries.
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
↗