Nano Banana 2 API
Next-gen Nano Banana with refined detail.
Integrate Nano Banana 2 with a single API call — one key, one unified endpoint, and shared billing across every model on Apiframe.
model: "nano-banana-2" What's special about Nano Banana 2
- Outputs at 1K / 2K / 4K.
- 5 aspect ratios, including 1:1, 3:4, 4:3.
- Image-to-image editing and reference-image support.
- Fast turnaround — about 12s per generation on average.
- Pay-as-you-go pricing with no Google account required — you only pay for successful generations.
- One API key, unified billing, idempotency and webhooks across every Apiframe model.
Made with Nano Banana 2
A few outputs generated through the Nano Banana 2 API on Apiframe.
A cinematic portrait of an astronaut in a neon-lit alley, 85mm, shallow depth of field
Cozy isometric coffee shop, warm morning light, highly detailed 3D render
A majestic snow leopard on a misty mountain ridge at golden hour
Overview
- Endpoint
- POST /v2/images/generate
- Model ID
- nano-banana-2
- Params key
- nanoBananaParams
- Modality
- image
- Provider
- Pricing
- Pay-as-you-go
- Avg. completion
- ~12s
Capabilities
Quick start
Send a single POST /v2/images/generate request with your API key to
generate with Nano Banana 2. The call returns a jobId you can poll or
receive via webhook.
curl -X POST https://api.apiframe.ai/v2/images/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "nano-banana-2",
"nanoBananaParams": {
"resolution": "1K",
"image_input": "https://example.com/input.jpg",
"output_format": "jpg",
"google_search": false
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/images/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "nano-banana-2",
"nanoBananaParams": {
"resolution": "1K",
"image_input": "https://example.com/input.jpg",
"output_format": "jpg",
"google_search": False
}
},
)
print(response.json()) # { "jobId": "...", "status": "QUEUED" }const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
"model": "nano-banana-2",
"nanoBananaParams": {
"resolution": "1K",
"image_input": "https://example.com/input.jpg",
"output_format": "jpg",
"google_search": false
}
}),
});
const { jobId } = await response.json();
console.log(jobId);Response & job lifecycle
Generation is asynchronous. A successful submission returns 202 Accepted
with a jobId. Poll GET /v2/jobs/{id} (or supply a
webhook_url) until the status is COMPLETED; the
result field then holds the output URL(s).
1. Submission response (202)
{
"jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"status": "QUEUED"
}2. Poll for the result
curl https://api.apiframe.ai/v2/jobs/JOB_ID \
-H "X-API-Key: afk_your_api_key_here"import requests, time
while True:
job = requests.get(
"https://api.apiframe.ai/v2/jobs/JOB_ID",
headers={"X-API-Key": "afk_your_api_key_here"},
).json()
if job["status"] in ("COMPLETED", "FAILED"):
break
time.sleep(2)
print(job["result"])let job;
do {
await new Promise((r) => setTimeout(r, 2000));
job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
headers: { "X-API-Key": "afk_your_api_key_here" },
}).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);Input schema
Request parameters accepted by the Nano Banana 2 endpoint. Model-specific options are nested under the params object shown below.
| Parameter | Type | Required | Default | Allowed / range | Description |
|---|---|---|---|---|---|
| prompt | string | required | — | — | Text description of what to generate. |
| model | string | required | "nano-banana-2" | "nano-banana-2" | The model identifier for this endpoint. |
| nanoBananaParams.resolution | string | optional | "1K" | "512px", "1K", "2K", "4K" | Resolution |
| nanoBananaParams.image_input | string (URL) | optional | — | — | Compose with or edit a reference image. |
| nanoBananaParams.output_format | string | optional | "jpg" | "jpg", "png", "webp" | Output format |
| nanoBananaParams.google_search | boolean | optional | false | — | Google search grounding |
| nanoBananaParams.image_search | boolean | optional | false | — | Image search grounding |
Frequently Asked Questions
Common questions about the Nano Banana 2 API.
Is there an API for Nano Banana 2?
Yes. Apiframe exposes Nano Banana 2 through a single REST endpoint (`POST /v2/images/generate` with `model: "nano-banana-2"`). You get one unified API, key, and billing across every supported model — no separate Google account required.
How much does the Nano Banana 2 API cost?
Nano Banana 2 uses simple pay-as-you-go pricing on Apiframe — you only pay for successful generations. See the pricing page for plans and volume discounts.
How do I call the Nano Banana 2 API?
Send a POST request to `/v2/images/generate` with your `X-API-Key` and a JSON body containing `model: "nano-banana-2"`. The call returns a `jobId`; poll `GET /v2/jobs/{id}` or use a webhook to receive the result.
What parameters does Nano Banana 2 support?
Nano Banana 2 accepts 5 model-specific parameters (nested under `nanoBananaParams`) plus the common `prompt` and `webhook_url` fields. See the input schema above for the full list with types and defaults.
Still have questions?
Start building with the Nano Banana 2 API
Get your API key and integrate Nano Banana 2 in minutes — Pay-as-you-go.
Questions? Join our Discord or contact sales.