Nano Banana 2 Image Edit
google/nano-banana-2/edit
4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.
Examples
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| images *Input Images | image_upload | — | image/* · 0–14 items | Upload up to 14 images for editing. The AI will modify these images based on your prompt. |
| prompt *Prompt | textarea | ≤ 5000 chars | Describe how you want to edit the images. Be specific about the changes, style adjustments, or modifications you want. | |
| aspect_ratioAspect Ratio | select | — | 1:1 | 3:2 | 2:3 | 3:4 | 4:3 | 4:5 | 5:4 | 9:16 | … | Choose the aspect ratio for the output image. If not specified, the original aspect ratio will be preserved. |
| resolutionResolution | select | 1k | 512 | 1k | 2k | 4k | Select the resolution of the output image. Higher resolution provides more detail but takes longer to process. |
API
Call this model through one unified REST API. Get a key on the API Keys page.
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2/edit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"images": [
"https://assets-public.namifusion.com/uploads/images/2026-03-25/869ddd43c5a6.png",
"https://assets-public.namifusion.com/uploads/images/2026-03-25/61fdd5b5c158.png",
"https://assets-public.namifusion.com/uploads/images/2026-03-25/80647d8e9174.png",
"https://assets-public.namifusion.com/uploads/images/2026-03-25/bea9401654ea.png"
],
"prompt": "Enhance the lighting in the image to create a dramatic effect, adjust the colors to make them more vibrant, and add subtle text overlays in multiple languages.",
"aspect_ratio": "16:9",
"resolution": "1k"
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2/edit",
headers=HEADERS,
json={
"input": {
"images": [
"https://assets-public.namifusion.com/uploads/images/2026-03-25/869ddd43c5a6.png",
"https://assets-public.namifusion.com/uploads/images/2026-03-25/61fdd5b5c158.png",
"https://assets-public.namifusion.com/uploads/images/2026-03-25/80647d8e9174.png",
"https://assets-public.namifusion.com/uploads/images/2026-03-25/bea9401654ea.png"
],
"prompt": "Enhance the lighting in the image to create a dramatic effect, adjust the colors to make them more vibrant, and add subtle text overlays in multiple languages.",
"aspect_ratio": "16:9",
"resolution": "1k"
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/google/nano-banana-2/edit", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"images": [
"https://assets-public.namifusion.com/uploads/images/2026-03-25/869ddd43c5a6.png",
"https://assets-public.namifusion.com/uploads/images/2026-03-25/61fdd5b5c158.png",
"https://assets-public.namifusion.com/uploads/images/2026-03-25/80647d8e9174.png",
"https://assets-public.namifusion.com/uploads/images/2026-03-25/bea9401654ea.png"
],
"prompt": "Enhance the lighting in the image to create a dramatic effect, adjust the colors to make them more vibrant, and add subtle text overlays in multiple languages.",
"aspect_ratio": "16:9",
"resolution": "1k"
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);Documentation
Google Nano Banana 2 Edit
Advanced Image Editing with 4K Output and Fast Iteration
Google Nano Banana 2 Edit (Gemini 3.1 Flash Image) is a cutting-edge image editing model that supports 4K resolution output, fast response times, and precise instruction adherence. It enables text translation, localization within images, and ensures subject consistency during edits. With no cold starts, top-tier performance, and affordable pricing, it is ready for seamless integration.
🚀 Key Features
- Natural Language Editing: Modify images using simple text instructions; the model understands context and relationships.
- Multi-Image Reference Support: Upload up to 14 reference images for complex edits and compositions.
- Multi-Resolution Output: Generate images in 1K, 2K, or 4K resolution based on your requirements.
- Flexible Aspect Ratios: Choose from various aspect ratios, including 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, and 8:1.
- Prompt Enhancer: Built-in tool to automatically refine your edit descriptions.
- Format Options: Export images in PNG or JPEG format.
🛠️ Technical Specifications
| Parameter | Description |
|---|---|
| Input Format | Images (up to 14 reference images) |
| Prompt | Positive prompt describing the desired edit |
| Aspect Ratio | Options: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1 |
| Resolution | Default: 1K; Options: 0.5K, 1K, 2K, 4K |
| Enable Web Search | Default: False; Enhance generation with real-time information when enabled |
| Enable Image Search | Default: False; Enhance generation with real-time image data when enabled |
| Output Format | Default: PNG; Options: PNG, JPEG |
Sample Prompts
- “Change the man to a woman.”
- “Replace the background with a beach scene.”
💰 Pricing
| Resolution | Cost |
|---|---|
| 0.5K | $0.045 |
| 1K | $0.07 |
| 2K | $0.105 |
| 4K | $0.14 |
| Web Search | +$0.014 |
| Image Search | +$0.014 |
💡 Best Use Cases
- Character Modification: Change attributes like gender, age, clothing, or appearance.
- Object Replacement: Swap elements within images while preserving context.
- Style Transfer: Apply different visual styles to existing images.
- Text Editing: Modify on-image text while maintaining design consistency.
- Scene Adjustment: Change backgrounds, lighting, or environmental elements.
🔗 Related Models
- Nano Banana 2 Text-to-Image: Generate images from text prompts.
- Nano Banana Pro Edit: Pro-tier editing with enhanced quality.
- Nano Banana Pro Text-to-Image: Pro-tier image generation.
Google Nano Banana 2 Edit empowers developers and creators with professional-grade image editing capabilities.
Related models
xAI Grok Imagine Image v2.0 Edit
xAI Grok Imagine Image V2.0 Edit transforms input images with text prompts, with configurable resolution and quality for precise image editing, visual refinements, creative variations, social content, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Qwen Image 3.0 Pro Edit | Fast Image Editing
Qwen Image 3.0 Pro Edit is a professional-grade image editing model with superior quality and advanced instruction understanding. Up to 2k. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Head Swap (Image)
Swap the head in a photo with the head from a reference image. Upload the target photo first, then the head reference.
Nami Qwen I2I Spicy
Edit a reference image with natural-language instructions while preserving the parts you do not ask to change.
Nano Banana Image Edit
Fast & Affordable Editing. Intuitive object replacement and style transfer without manual masking.
Nano Banana Pro Image Edit
4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.
Seedream V5.0 Pro Edit API
Seedream V5.0 Pro Edit by ByteDance edits and generates images from single-image or multi-reference inputs, supporting up to 10 reference images, aspect ratio selection, and 1K / 2K output tiers. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Seedream 5.0 Lite Edit Sequential
Seedream 5.0 Lite Edit Sequential performs multi-image editing while locking character and object identity across shots. It detects main subjects, preserves continuity, and applies controlled edits with up to 4K output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.