Nano Banana 2 API, Nano Banana Pro API, Nano Banana API - AI Image Generation APIs
by Google
Nano Banana 2 API, developers can access both standard and pro variants for text-to-image generation and image-to-image editing. The API combines Google's advanced AI research with practical image generation features, offering reliable quality for applications ranging from creative tools to automated content production.

Models Version
Get $5 Free Credit on First Payment
No strings attached — add funds and get $5 bonus instantly
Nano Banana 2 Text to Image API Documentation
https://gateway.pixazo.ai/nano-banana-2/v1
Authentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your API subscription key |
Nano Banana 2 generate request
Request Code
POST https://gateway.pixazo.ai/nano-banana-2/v1/nano-banana-2-request
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_API_KEY
{
"prompt": "A futuristic cityscape at golden hour with neon-lit skyscrapers and reflections on wet streets",
"num_images": 1,
"aspect_ratio": "16:9",
"output_format": "png",
"safety_tolerance": "4",
"resolution": "1K",
"sync_mode": false,
"limit_generations": true,
"enable_web_search": false
}
import requests
url = "https://gateway.pixazo.ai/nano-banana-2/v1/nano-banana-2-request"
headers = {
"Content-Type": "application/json",
"Cache-Control": "no-cache",
"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
data = {
"prompt": "A futuristic cityscape at golden hour with neon-lit skyscrapers and reflections on wet streets",
"num_images": 1,
"aspect_ratio": "16:9",
"output_format": "png",
"safety_tolerance": "4",
"resolution": "1K",
"sync_mode": false,
"limit_generations": true,
"enable_web_search": false
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = "https://gateway.pixazo.ai/nano-banana-2/v1/nano-banana-2-request";
const headers = {
"Content-Type": "application/json",
"Cache-Control": "no-cache",
"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
};
const data = {
"prompt": "A futuristic cityscape at golden hour with neon-lit skyscrapers and reflections on wet streets",
"num_images": 1,
"aspect_ratio": "16:9",
"output_format": "png",
"safety_tolerance": "4",
"resolution": "1K",
"sync_mode": false,
"limit_generations": true,
"enable_web_search": false
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data));
curl -X POST "https://gateway.pixazo.ai/nano-banana-2/v1/nano-banana-2-request" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
--data-raw '{
"prompt": "A futuristic cityscape at golden hour with neon-lit skyscrapers and reflections on wet streets",
"num_images": 1,
"aspect_ratio": "16:9",
"output_format": "png",
"safety_tolerance": "4",
"resolution": "1K",
"sync_mode": false,
"limit_generations": true,
"enable_web_search": false
}'
Output
{
"request_id": "nano-banana-2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Webhook (Optional)
Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.
X-Webhook-URL: https://your-server.com/webhook/callback
Request Parameters - Nano Banana 2 generate request
| Parameter | Required | Type | Default | Allowed values / range | Description |
|---|---|---|---|---|---|
| prompt | Yes | string | — | 3–50,000 characters | Text prompt for image generation (3-50,000 characters) |
| num_images | No | integer | 1 | 1–4 | Number of images to generate (allowed values: 1-4) |
| aspect_ratio | No | string | "auto" | "auto", "21:9", "16:9", "3:2", "4:3", "5:4", "1:1", "4:5", "3:4", "2:3", "9:16", "4:1", "1:4", "8:1", "1:8" | Image aspect ratio. Allowed: `auto`, `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`, `4:1`, `1:4`, `8:1`, `1:8` |
| resolution | No | string | "1K" | "0.5K", "1K", "2K", "4K" | Output resolution. Allowed: `0.5K`, `1K`, `2K`, `4K` |
| output_format | No | string | "png" | "jpeg", "png", "webp" | Output file format. Allowed: `jpeg`, `png`, `webp` |
| safety_tolerance | No | string | "4" | "1", "2", "3", "4", "5", "6" | Safety filtering level. Allowed: `1`, `2`, `3`, `4`, `5`, `6` (higher = stricter) |
| seed | No | integer | — | — | Random seed for reproducible results |
| system_prompt | No | string | "" | 0–50,000 characters | Optional system instruction to steer model persona (0-50,000 characters) |
| limit_generations | No | boolean | true | — | Experimental; limits generations to 1 per round |
| enable_web_search | No | boolean | false | — | Enable web search grounding for generation |
| thinking_level | No | string | — | "minimal", "high" | Cognitive processing level. Allowed: `minimal`, `high` (omit to disable) |
| sync_mode | No | boolean | false | — | If true, returns media as data URI inline instead of URLs |
Example Request
{
"prompt": "A futuristic cityscape at golden hour with neon-lit skyscrapers and reflections on wet streets",
"num_images": 1,
"aspect_ratio": "16:9",
"output_format": "png",
"safety_tolerance": "4",
"resolution": "1K",
"sync_mode": false,
"limit_generations": true,
"enable_web_search": false
}
Response
{
"request_id": "nano-banana-2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Request Headers
| Header | Value |
|---|---|
| Content-Type | application/json |
| Cache-Control | no-cache |
| Ocp-Apim-Subscription-Key | YOUR_API_KEY |
Response Handling
Common status codes.
| Code | Meaning |
|---|---|
| 202 | Accepted — Request queued |
| 400 | Bad Request |
| 401 | Unauthorized |
| 402 | Insufficient Balance |
| 403 | Forbidden |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Error Responses
Queue system errors and model validation errors.
Queue System Errors
// 402 — Insufficient balance
{
"error": "Insufficient Balance",
"message": "Your wallet does not have enough balance."
}
// 400 — Model not found
{
"error": "Model not found",
"message": "Model 'nano-banana-2' not found or is disabled"
}
Error via Status/Webhook
{
"request_id": "nano-banana-2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "ERROR",
"model_id": "nano-banana-2",
"error": "Description of the error",
"output": null
}
Retrieving Results
Poll the universal status endpoint to check progress and retrieve results.
Endpoint
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
cURL Example
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://gateway.pixazo.ai/v2/requests/status/nano-banana-2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Response (Completed)
{
"request_id": "nano-banana-2_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "COMPLETED",
"model_id": "nano-banana-2",
"error": null,
"output": {
"media_url": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019dxxxx/output.png"],
"media_type": "image/png"
},
"created_at": "2026-03-31T10:00:00.000Z",
"updated_at": "2026-03-31T10:00:15.000Z",
"completed_at": "2026-03-31T10:00:15.000Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR |
| model_id | string | Model that processed the request |
| error | string|null | Error message if failed |
| output.media_url | array | URLs to generated media (R2 CDN) |
| output.media_type | string | MIME type of the output |
| created_at | string | When request was created |
| completed_at | string | When request completed |
| polling_url | string | Status URL (initial response only) |
Status Values
| Status | Description |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
QUEUED → PROCESSING → COMPLETED
→ FAILED
→ ERROR
Typical Workflow
- Send a generate request to the API endpoint
- Save the
request_idfrom the response - Poll every 5-10 seconds:
GET /v2/requests/status/{request_id} - When
statusis"COMPLETED", download fromoutput.media_url
Tip: Use X-Webhook-URL header to get a callback instead of polling.
Nano Banana 2 Text to Image API Pricing
| Resolution | Price (USD) |
|---|---|
| 1K | $0.067 |
| 2K | $0.101 |
| 4K | $0.151 |
Nano Banana 2 Image to Image (Image Editing) API Documentation
https://gateway.pixazo.ai/nano-banana-2-edit/v1
Authentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your API subscription key |
Nano Banana 2 Edit generate request - Nano Banana 2 Edit
Request Code
POST https://gateway.pixazo.ai/nano-banana-2-edit/v1/nano-banana-2-edit-request
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
{
"prompt": "Place the subject in front of a tropical beach with palm trees and turquoise water",
"image_urls": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png",
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png"
],
"num_images": 1
}
import requests
url = "https://gateway.pixazo.ai/nano-banana-2-edit/v1/nano-banana-2-edit-request"
headers = {
"Content-Type": "application/json",
"Cache-Control": "no-cache",
"Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
"prompt": "Place the subject in front of a tropical beach with palm trees and turquoise water",
"image_urls": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png",
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png"
],
"num_images": 1
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = "https://gateway.pixazo.ai/nano-banana-2-edit/v1/nano-banana-2-edit-request";
const headers = {
"Content-Type": "application/json",
"Cache-Control": "no-cache",
"Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
};
const data = {
prompt: "Place the subject in front of a tropical beach with palm trees and turquoise water",
image_urls: [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png",
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png"
],
num_images: 1
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
curl -X POST "https://gateway.pixazo.ai/nano-banana-2-edit/v1/nano-banana-2-edit-request" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
"prompt": "Place the subject in front of a tropical beach with palm trees and turquoise water",
"image_urls": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png",
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png"
],
"num_images": 1
}'
Output
{
"request_id": "nano-banana-2-edit_019e3f4a-b4ef-75df-c4bf-8e7804c819bf7",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-2-edit_019e3f4a-b4ef-75df-c4bf-8e7804c819bf7"
}
Webhook (Optional)
Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.
{
"prompt": "Place the subject in front of a tropical beach with palm trees and turquoise water",
"image_urls": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png"
],
"num_images": 1
}
Full Request (all options)
{
"prompt": "Place the subject in front of a tropical beach with palm trees and turquoise water",
"image_urls": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png",
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2_019e3b41-0ab0-74a9-9b39-a8526448883eb/output.png"
],
"num_images": 1,
"aspect_ratio": "auto",
"output_format": "png",
"resolution": "1K",
"limit_generations": true
}
Response
{
"request_id": "nano-banana-2-edit_019e3f4a-b4ef-75df-c4bf-8e7804c819bf7",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-2-edit_019e3f4a-b4ef-75df-c4bf-8e7804c819bf7"
}
Request Headers
| Header | Value |
|---|---|
| Content-Type | application/json |
| Cache-Control | no-cache |
| Ocp-Apim-Subscription-Key | Your API subscription key |
Response Handling
Common status codes for Nano Banana 2 Edit generate request.
| Code | Meaning |
|---|---|
| 202 | Accepted — Request queued |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Response Handling
Common status codes.
| Code | Meaning |
|---|---|
| 202 | Accepted — Request queued |
| 400 | Bad Request |
| 401 | Unauthorized |
| 402 | Insufficient Balance |
| 403 | Forbidden |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Error Responses
Queue system errors and model validation errors.
Queue System Errors
// 402 — Insufficient balance
{
"error": "Insufficient Balance",
"message": "Your wallet does not have enough balance."
}
// 400 — Model not found
{
"error": "Model not found",
"message": "Model 'nano-banana-2-edit' not found or is disabled"
}
Error via Status/Webhook
{
"request_id": "nano-banana-2-edit_019e3f4a-b4ef-75df-c4bf-8e7804c819bf7",
"status": "ERROR",
"model_id": "nano-banana-2-edit",
"error": "Description of the error",
"output": null
}
Retrieving Results
Poll the universal status endpoint to check progress and retrieve results.
Endpoint
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
cURL Example
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://gateway.pixazo.ai/v2/requests/status/nano-banana-2-edit_019e3f4a-b4ef-75df-c4bf-8e7804c819bf7"
Response (Completed)
{
"request_id": "nano-banana-2-edit_019e3f4a-b4ef-75df-c4bf-8e7804c819bf7",
"status": "COMPLETED",
"model_id": "nano-banana-2-edit",
"error": null,
"output": {
"media_url": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-2-edit_019e3f4a-b4ef-75df-c4bf-8e7804c819bf7/output.png"
],
"media_type": "image/png"
},
"created_at": "2026-05-19T08:12:01.830Z",
"updated_at": "2026-05-19 08:12:49",
"completed_at": "2026-05-19 08:12:49"
}
Response Fields
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR |
| model_id | string | Model that processed the request |
| error | string|null | Error message if failed |
| output.media_url | array | URLs to generated media (R2 CDN) |
| output.media_type | string | MIME type of the output |
| created_at | string | When request was created |
| completed_at | string|null | When request completed |
| polling_url | string | Status URL (initial response only) |
Status Values
| Status | Description |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
QUEUED → PROCESSING → COMPLETED
→ FAILED
→ ERROR
Typical Workflow
- Send a generate request to the API endpoint
- Save the
request_idfrom the response - Poll every 5-10 seconds:
GET /v2/requests/status/{request_id} - When
statusis"COMPLETED", download fromoutput.media_url
Tip: Use X-Webhook-URL header to get a callback instead of polling.
Nano Banana 2 Image to Image (Image Editing) API Pricing
| Resolution | Price (USD) |
|---|---|
| 1K | $0.067 |
| 2K | $0.101 |
| 4K | $0.151 |
Nano Banana Pro Image to Image (Image Editing) API Documentation
https://gateway.pixazo.ai/nano-banana-pro-770/v1
Authentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your API subscription key |
Generate Request - Nano Banana Pro API
Request Code
POST https://gateway.pixazo.ai/nano-banana-pro-770/v1/nano-banana-pro-request
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
{
"prompt": "make a photo of the man driving the car down the california coastline",
"image_urls": [
"https://example.com/example_inputs/nano-banana-edit-input.png",
"https://example.com/example_inputs/nano-banana-edit-input-2.png"
]
}
import requests
url = "https://gateway.pixazo.ai/nano-banana-pro-770/v1/nano-banana-pro-request"
headers = {
"Content-Type": "application/json",
"Cache-Control": "no-cache",
"Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
"prompt": "make a photo of the man driving the car down the california coastline",
"image_urls": [
"https://example.com/example_inputs/nano-banana-edit-input.png",
"https://example.com/example_inputs/nano-banana-edit-input-2.png"
]
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = 'https://gateway.pixazo.ai/nano-banana-pro-770/v1/nano-banana-pro-request';
const data = {
prompt: 'make a photo of the man driving the car down the california coastline',
image_urls: [
'https://example.com/example_inputs/nano-banana-edit-input.png',
'https://example.com/example_inputs/nano-banana-edit-input-2.png'
]
};
fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
},
body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -X POST "https://gateway.pixazo.ai/nano-banana-pro-770/v1/nano-banana-pro-request" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
"prompt": "make a photo of the man driving the car down the california coastline",
"image_urls": [
"https://example.com/example_inputs/nano-banana-edit-input.png",
"https://example.com/example_inputs/nano-banana-edit-input-2.png"
]
}'
Output
{
"request_id": "nano-banana-pro-770_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-pro-770_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Webhook (Optional)
Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.
X-Webhook-URL: https://your-server.com/webhook/callback
Request Parameters - Generate Request
| Parameter | Required | Type | Description |
|---|---|---|---|
| prompt | Yes | string | The prompt describing the desired image edit or transformation. Clearly specify what should be changed, added, or preserved in the input images. |
| image_urls | Yes | array<string> | List of HTTPS URLs of images used for image-to-image generation or editing. Images must be publicly accessible. |
| num_images | No | integer | Number of images to generate. |
| aspect_ratio | No | string | Aspect ratio of the generated image. Possible values: auto, 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16. |
| output_format | No | string | Output image format. Possible values: jpeg, png, webp. |
| resolution | No | string | Resolution of the generated image. Possible values: 1K, 2K, 4K. |
| sync_mode | No | boolean | If true, the generated image is returned as a data URI and not stored in request history. |
| limit_generations | No | boolean | Experimental parameter that limits the number of generations per prompt round to 1. When set to true, any instructions in the prompt requesting multiple images are ignored. |
| enable_web_search | No | boolean | Enables web search during image generation, allowing the model to use up-to-date information from the web. |
Example Request
{
"prompt": "make a photo of the man driving the car down the california coastline",
"image_urls": [
"https://example.com/example_inputs/nano-banana-edit-input.png",
"https://example.com/example_inputs/nano-banana-edit-input-2.png"
]
}
Response
{
"request_id": "nano-banana-pro-770_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-pro-770_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Request Headers
| Header | Value |
|---|---|
| Content-Type | application/json |
| Cache-Control | no-cache |
| Ocp-Apim-Subscription-Key | YOUR_SUBSCRIPTION_KEY |
Response Handling
Common status codes.
| Code | Meaning |
|---|---|
| 202 | Accepted — Request queued |
| 400 | Bad Request |
| 401 | Unauthorized |
| 402 | Insufficient Balance |
| 403 | Forbidden |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Error Responses
Queue system errors and model validation errors.
Queue System Errors
// 402 — Insufficient balance
{
"error": "Insufficient Balance",
"message": "Your wallet does not have enough balance."
}
// 400 — Model not found
{
"error": "Model not found",
"message": "Model 'nano-banana-pro-770' not found or is disabled"
}
Error via Status/Webhook
{
"request_id": "nano-banana-pro-770_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "ERROR",
"model_id": "nano-banana-pro-770",
"error": "Description of the error",
"output": null
}
Retrieving Results
Poll the universal status endpoint to check progress and retrieve results.
Endpoint
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
cURL Example
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://gateway.pixazo.ai/v2/requests/status/nano-banana-pro-770_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Response (Completed)
{
"request_id": "nano-banana-pro-770_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "COMPLETED",
"model_id": "nano-banana-pro-770",
"error": null,
"output": {
"media_url": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-pro-770_019dxxxx-xxxx/output.ext"
],
"media_type": "application/octet-stream"
},
"created_at": "2026-03-31T10:00:00.000Z",
"updated_at": "2026-03-31T10:00:15.000Z",
"completed_at": "2026-03-31T10:00:15.000Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR |
| model_id | string | Model that processed the request |
| error | string|null | Error message if failed |
| output.media_url | array | URLs to generated media (R2 CDN) |
| output.media_type | string | MIME type of the output |
| created_at | string | When request was created |
| completed_at | string|null | When request completed |
| polling_url | string | Status URL (initial response only) |
Status Values
| Status | Description |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
QUEUED → PROCESSING → COMPLETED
→ FAILED
→ ERROR
Typical Workflow
- Send a generate request to the API endpoint
- Save the
request_idfrom the response - Poll every 5-10 seconds:
GET /v2/requests/status/{request_id} - When
statusis"COMPLETED", download fromoutput.media_url
Tip: Use X-Webhook-URL header to get a callback instead of polling.
Nano Banana Pro Image to Image (Image Editing) API Pricing
| Resolution | Price (USD) |
|---|---|
| 1K | $0.15 |
| 2K | $0.15 |
| 4K | $0.3 |
Nano Banana Pro Image to Image (Image Editing — Batch) API Documentation
https://gateway.pixazo.ai/nano-banana-pro-async/v1
Authentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your API subscription key |
Image to Image(Edit Image) - Nano Banana Pro Async API
Request Code
POST https://gateway.pixazo.ai/nano-banana-pro-async/v1/nano-banana-pro-image-to-image
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
{
"prompt": "Convert tree flower to yellow saffron",
"image_urls": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f2.png"]
}
import requests
APIM_KEY = 'YOUR_SUBSCRIPTION_KEY'
BASE_URL = 'https://gateway.pixazo.ai/nano-banana-pro-async/v1'
headers = {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Ocp-Apim-Subscription-Key': APIM_KEY
}
response = requests.post(
f'{BASE_URL}/nano-banana-pro-image-to-image',
headers=headers,
json={
'prompt': 'Convert tree flower to yellow saffron',
'image_urls': ['https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f2.png']
}
)
data = response.json()
print(data)
const APIM_KEY = 'YOUR_SUBSCRIPTION_KEY';
const BASE_URL = 'https://gateway.pixazo.ai/nano-banana-pro-async/v1';
async function generateTransformation() {
const response = await fetch(`${BASE_URL}/nano-banana-pro-image-to-image`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Ocp-Apim-Subscription-Key': APIM_KEY
},
body: JSON.stringify({
prompt: 'Convert tree flower to yellow saffron',
image_urls: ['https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f2.png']
})
});
const data = await response.json();
console.log('Task Started:', data.taskId);
}
curl -v -X POST "https://gateway.pixazo.ai/nano-banana-pro-async/v1/nano-banana-pro-image-to-image" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
"prompt": "Convert tree flower to yellow saffron",
"image_urls": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f2.png"]
}'
Output
{
"request_id": "nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Webhook (Optional)
Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.
X-Webhook-URL: https://your-server.com/webhook/callback
Request Parameters - Image to Image(Edit Image)
| Parameter | Required | Type | Description |
|---|---|---|---|
| prompt | Yes | string | Text description of the desired transformation (required) |
| image_urls | Yes | string[] | Array of input image URLs (1-5 images required) |
| num_images | No | integer | Number of image variations to generate (1-10) |
| aspect_ratio | No | string | Output image aspect ratio (see options below) |
| resolution | No | string | Output image resolution: "1K", "2K", or "4K" |
| enable_web_search | No | boolean | Enable Google Search grounding for more accurate results |
| sync_mode | No | boolean | Return base64 data URIs instead of R2 URLs |
| webhook | No | string | Webhook URL for automatic completion notifications |
Example Request
{
"prompt": "Transform into cyberpunk style with neon lights and holographic effects",
"image_urls": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f2.png"
],
"num_images": 3,
"aspect_ratio": "16:9",
"resolution": "1K",
"enable_web_search": true,
"sync_mode": false,
"webhook": "https://your-domain.com/api/webhook/gemini"
}
Response
{
"request_id": "nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Request Headers
| Header | Value |
|---|---|
| Content-Type | application/json |
| Cache-Control | no-cache |
| Ocp-Apim-Subscription-Key | YOUR_SUBSCRIPTION_KEY |
Response Handling
Common status codes.
| Code | Meaning |
|---|---|
| 202 | Accepted — Request queued |
| 400 | Bad Request |
| 401 | Unauthorized |
| 402 | Insufficient Balance |
| 403 | Forbidden |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Error Responses
Queue system errors and model validation errors.
Queue System Errors
// 402 — Insufficient balance
{
"error": "Insufficient Balance",
"message": "Your wallet does not have enough balance."
}
// 400 — Model not found
{
"error": "Model not found",
"message": "Model 'nano-banana-pro-async-api' not found or is disabled"
}
Error via Status/Webhook
{
"request_id": "nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "ERROR",
"model_id": "nano-banana-pro-async-api",
"error": "Description of the error",
"output": null
}
Retrieving Results
Poll the universal status endpoint to check progress and retrieve results.
Endpoint
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
cURL Example
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://gateway.pixazo.ai/v2/requests/status/nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Response (Completed)
{
"request_id": "nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "COMPLETED",
"model_id": "nano-banana-pro-async-api",
"error": null,
"output": {
"media_url": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-pro-async-api_019dxxxx-xxxx/output.ext"
],
"media_type": "application/octet-stream"
},
"created_at": "2026-03-31T10:00:00.000Z",
"updated_at": "2026-03-31T10:00:15.000Z",
"completed_at": "2026-03-31T10:00:15.000Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR |
| model_id | string | Model that processed the request |
| error | string|null | Error message if failed |
| output.media_url | array | URLs to generated media (R2 CDN) |
| output.media_type | string | MIME type of the output |
| created_at | string | When request was created |
| completed_at | string|null | When request completed |
| polling_url | string | Status URL (initial response only) |
Status Values
| Status | Description |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
QUEUED → PROCESSING → COMPLETED
→ FAILED
→ ERROR
Typical Workflow
- Send a generate request to the API endpoint
- Save the
request_idfrom the response - Poll every 5-10 seconds:
GET /v2/requests/status/{request_id} - When
statusis"COMPLETED", download fromoutput.media_url
Tip: Use X-Webhook-URL header to get a callback instead of polling.
Nano Banana Pro Image to Image (Image Editing — Batch) API Pricing
| Resolution | Price (USD) |
|---|---|
| 1K | $0.08 |
| 2K | $0.08 |
| 4K | $0.12 |
Nano Banana Pro Text to Image (Batch) API Documentation
https://gateway.pixazo.ai/nano-banana-pro-async/v1
Authentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your API subscription key |
Text to Image - Nano Banana Pro Async API
Request Code
POST https://gateway.pixazo.ai/nano-banana-pro-async/v1/nano-banana-pro-text-to-image
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
{
"prompt": "A cute robot"
}
import requests
APIM_KEY = 'YOUR_SUBSCRIPTION_KEY'
BASE_URL = 'https://gateway.pixazo.ai/nano-banana-pro-async/v1'
headers = {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Ocp-Apim-Subscription-Key': APIM_KEY
}
response = requests.post(
f'{BASE_URL}/nano-banana-pro-text-to-image',
headers=headers,
json={
'prompt': 'A cute robot'
}
)
data = response.json()
print('Task ID:', data['taskId'])
// Node.js example
const APIM_KEY = 'YOUR_SUBSCRIPTION_KEY';
const BASE_URL = 'https://gateway.pixazo.ai/nano-banana-pro-async/v1';
async function generateImage() {
const response = await fetch(`${BASE_URL}/nano-banana-pro-text-to-image`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Ocp-Apim-Subscription-Key': APIM_KEY
},
body: JSON.stringify({
prompt: 'A cute robot'
})
});
const data = await response.json();
console.log('Image generation started!');
console.log('Task ID:', data.taskId);
}
generateImage();
curl -X POST "https://gateway.pixazo.ai/nano-banana-pro-async/v1/nano-banana-pro-text-to-image" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
"prompt": "A cute robot"
}'
Output
{
"request_id": "nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Webhook (Optional)
Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.
X-Webhook-URL: https://your-server.com/webhook/callback
Request Parameters - Text to Image
| Parameter | Required | Type | Description |
|---|---|---|---|
| prompt | Yes | string | Text description of the desired image (required) |
| num_images | No | integer | Number of image variations to generate (1-10) |
| aspect_ratio | No | string | Image aspect ratio (see options below) |
| resolution | No | string | Image resolution: "1K", "2K", or "4K" |
| enable_web_search | No | boolean | Enable Google Search grounding for more accurate results |
| sync_mode | No | boolean | Return base64 data URIs instead of R2 URLs |
| webhook | No | string | Webhook URL for automatic completion notifications |
Example Request
{
"prompt": "A futuristic city on Mars with flying cars and neon lights at sunset",
"num_images": 4,
"aspect_ratio": "16:9",
"resolution": "4K",
"enable_web_search": true,
"sync_mode": false,
"webhook": "https://your-domain.com/api/webhook/gemini"
}
Response
{
"request_id": "nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Request Headers
| Header | Value |
|---|---|
| Content-Type | application/json |
| Cache-Control | no-cache |
| Ocp-Apim-Subscription-Key | YOUR_SUBSCRIPTION_KEY |
Response Handling
Common status codes.
| Code | Meaning |
|---|---|
| 202 | Accepted — Request queued |
| 400 | Bad Request |
| 401 | Unauthorized |
| 402 | Insufficient Balance |
| 403 | Forbidden |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Error Responses
Queue system errors and model validation errors.
Queue System Errors
// 402 — Insufficient balance
{
"error": "Insufficient Balance",
"message": "Your wallet does not have enough balance."
}
// 400 — Model not found
{
"error": "Model not found",
"message": "Model 'nano-banana-pro-async-api' not found or is disabled"
}
Error via Status/Webhook
{
"request_id": "nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "ERROR",
"model_id": "nano-banana-pro-async-api",
"error": "Description of the error",
"output": null
}
Retrieving Results
Poll the universal status endpoint to check progress and retrieve results.
Endpoint
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
cURL Example
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://gateway.pixazo.ai/v2/requests/status/nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Response (Completed)
{
"request_id": "nano-banana-pro-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "COMPLETED",
"model_id": "nano-banana-pro-async-api",
"error": null,
"output": {
"media_url": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-pro-async-api_019dxxxx-xxxx/output.ext"
],
"media_type": "application/octet-stream"
},
"created_at": "2026-03-31T10:00:00.000Z",
"updated_at": "2026-03-31T10:00:15.000Z",
"completed_at": "2026-03-31T10:00:15.000Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR |
| model_id | string | Model that processed the request |
| error | string|null | Error message if failed |
| output.media_url | array | URLs to generated media (R2 CDN) |
| output.media_type | string | MIME type of the output |
| created_at | string | When request was created |
| completed_at | string|null | When request completed |
| polling_url | string | Status URL (initial response only) |
Status Values
| Status | Description |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
QUEUED → PROCESSING → COMPLETED
→ FAILED
→ ERROR
Typical Workflow
- Send a generate request to the API endpoint
- Save the
request_idfrom the response - Poll every 5-10 seconds:
GET /v2/requests/status/{request_id} - When
statusis"COMPLETED", download fromoutput.media_url
Tip: Use X-Webhook-URL header to get a callback instead of polling.
Nano Banana Pro Text to Image (Batch) API Pricing
| Resolution | Price (USD) |
|---|---|
| 1K | $0.08 |
| 2K | $0.08 |
| 4K | $0.12 |
Nano Banana Standard Image to Image (Image Editing) API Documentation
https://gateway.pixazo.ai/nano-banana/v1
Authentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your API subscription key |
Edit Image Request - Nano Banana API
Request Code
POST https://gateway.pixazo.ai/nano-banana/v1/nano-banana/generateEditImageRequest
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
{
"prompt": "Add a sunset background to the beach photo",
"image_urls": [
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
],
"num_images": 1,
"output_format": "jpeg",
"sync_mode": false
}
import requests
url = "https://gateway.pixazo.ai/nano-banana/v1/nano-banana/generateEditImageRequest"
headers = {
"Content-Type": "application/json",
"Cache-Control": "no-cache",
"Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
"prompt": "Add a sunset background to the beach photo",
"image_urls": [
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
],
"num_images": 1,
"output_format": "jpeg",
"sync_mode": False
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = 'https://gateway.pixazo.ai/nano-banana/v1/nano-banana/generateEditImageRequest';
const data = {
prompt: 'Add a sunset background to the beach photo',
image_urls: [
'https://example.com/image1.jpg',
'https://example.com/image2.jpg'
],
num_images: 1,
output_format: 'jpeg',
sync_mode: false
};
fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
},
body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -v -X POST "https://gateway.pixazo.ai/nano-banana/v1/nano-banana/generateEditImageRequest" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
"prompt": "Add a sunset background to the beach photo",
"image_urls": [
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
],
"num_images": 1,
"output_format": "jpeg",
"sync_mode": false
}'
Output
{
"request_id": "nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Webhook (Optional)
Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.
X-Webhook-URL: https://your-server.com/webhook/callback
Request Parameters - Edit Image Request
| Parameter | Required | Type | Description |
|---|---|---|---|
| prompt | Yes | string | The prompt for image editing. Google's state-of-the-art image editing model that modifies existing images based on text descriptions |
| image_urls | Yes | array<string> | List of URLs of input images for editing. The images will be edited according to the provided prompt |
| num_images | Optional | integer | The number of edited images to generate |
| output_format | Optional | string | The format of the generated images. Values: "jpeg", "png" |
| sync_mode | Optional | boolean | When true, edited images will be returned as data URIs instead of URLs |
Example Request
{
"prompt": "Add a sunset background to the beach photo",
"image_urls": [
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
],
"num_images": 1,
"output_format": "jpeg",
"sync_mode": false
}
Response
{
"request_id": "nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Request Headers
| Header | Value |
|---|---|
| Content-Type | application/json |
| Cache-Control | no-cache |
| Ocp-Apim-Subscription-Key | YOUR_SUBSCRIPTION_KEY |
Response Handling
Common status codes.
| Code | Meaning |
|---|---|
| 202 | Accepted — Request queued |
| 400 | Bad Request |
| 401 | Unauthorized |
| 402 | Insufficient Balance |
| 403 | Forbidden |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Error Responses
Queue system errors and model validation errors.
Queue System Errors
// 402 — Insufficient balance
{
"error": "Insufficient Balance",
"message": "Your wallet does not have enough balance."
}
// 400 — Model not found
{
"error": "Model not found",
"message": "Model 'nano-banana' not found or is disabled"
}
Error via Status/Webhook
{
"request_id": "nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "ERROR",
"model_id": "nano-banana",
"error": "Description of the error",
"output": null
}
Retrieving Results
Poll the universal status endpoint to check progress and retrieve results.
Endpoint
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
cURL Example
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://gateway.pixazo.ai/v2/requests/status/nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Response (Completed)
{
"request_id": "nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "COMPLETED",
"model_id": "nano-banana",
"error": null,
"output": {
"media_url": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana_019dxxxx-xxxx/output.ext"
],
"media_type": "application/octet-stream"
},
"created_at": "2026-03-31T10:00:00.000Z",
"updated_at": "2026-03-31T10:00:15.000Z",
"completed_at": "2026-03-31T10:00:15.000Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR |
| model_id | string | Model that processed the request |
| error | string|null | Error message if failed |
| output.media_url | array | URLs to generated media (R2 CDN) |
| output.media_type | string | MIME type of the output |
| created_at | string | When request was created |
| completed_at | string|null | When request completed |
| polling_url | string | Status URL (initial response only) |
Status Values
| Status | Description |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
QUEUED → PROCESSING → COMPLETED
→ FAILED
→ ERROR
Typical Workflow
- Send a generate request to the API endpoint
- Save the
request_idfrom the response - Poll every 5-10 seconds:
GET /v2/requests/status/{request_id} - When
statusis"COMPLETED", download fromoutput.media_url
Tip: Use X-Webhook-URL header to get a callback instead of polling.
Nano Banana Standard Image to Image (Image Editing) API Pricing
| Resolution | Price (USD) |
|---|---|
| 1024×1024 (1:1) | $0.06 |
| 1920×1080 (16:9) | $0.1188 |
| 2560×1096 (21:9) | $0.1608 |
| 1800×1200 (3:2) | $0.1236 |
| 1200×1800 (2:3) | $0.1236 |
| 1080×1350 (4:5) | $0.0834 |
| 1250×1000 (5:4) | $0.0714 |
| 1080×1440 (3:4) | $0.0888 |
| 1440×1080 (4:3) | $0.0888 |
| 1080×1920 (9:16) | $0.1188 |
Nano Banana Standard Text to Image API Documentation
https://gateway.pixazo.ai/nano-banana/v1
Authentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your API subscription key |
Text To Image Request - Nano Banana API
Request Code
POST https://gateway.pixazo.ai/nano-banana/v1/nano-banana/generateTextToImageRequest
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
{
"prompt": "An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half, revealing both the dogs head above water holding a tennis ball in it's mouth, and it's paws paddling underwater.",
"num_images": 1,
"limit_generations": false,
"output_format": "jpeg",
"aspect_ratio": "16:9",
"sync_mode": false
}
import requests
url = "https://gateway.pixazo.ai/nano-banana/v1/nano-banana/generateTextToImageRequest"
headers = {
"Content-Type": "application/json",
"Cache-Control": "no-cache",
"Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
"prompt": "An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half, revealing both the dogs head above water holding a tennis ball in it's mouth, and it's paws paddling underwater.",
"num_images": 1,
"limit_generations": False,
"output_format": "jpeg",
"aspect_ratio": "16:9",
"sync_mode": False
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = 'https://gateway.pixazo.ai/nano-banana/v1/nano-banana/generateTextToImageRequest';
const headers = {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
};
const data = {
prompt: 'An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half, revealing both the dogs head above water holding a tennis ball in it\'s mouth, and it\'s paws paddling underwater.',
num_images: 1,
limit_generations: false,
output_format: 'jpeg',
aspect_ratio: '16:9',
sync_mode: false
};
fetch(url, {
method: 'POST',
headers: headers,
body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -v -X POST "https://gateway.pixazo.ai/nano-banana/v1/nano-banana/generateTextToImageRequest" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
"prompt": "An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half, revealing both the dogs head above water holding a tennis ball in it\'s mouth, and it\'s paws paddling underwater.",
"num_images": 1,
"limit_generations": false,
"output_format": "jpeg",
"aspect_ratio": "16:9",
"sync_mode": false
}'
Output
{
"request_id": "nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Webhook (Optional)
Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.
X-Webhook-URL: https://your-server.com/webhook/callback
Request Parameters - Text To Image Request
| Parameter | Required | Type | Description |
|---|---|---|---|
| prompt | Yes | string | The prompt for image generation. Google's state-of-the-art image generation model that generates high-quality images based on text descriptions |
| num_images | No | integer | The number of images to generate |
| limit_generations | No | boolean | Experimental parameter to limit the number of generations from each round of prompting to 1. Set to True to disregard any instructions in the prompt regarding the number of images to generate |
| output_format | No | string | The format of the generated images. Values: "jpeg", "png", "webp" |
| aspect_ratio | No | string | Aspect ratio for generated images. Values: "21:9", "1:1", "4:3", "3:2", "2:3", "5:4", "4:5", "3:4", "16:9", "9:16" |
| sync_mode | No | boolean | If True, the media will be returned as a data URI and the output data won't be available in the request history |
Example Request
{
"prompt": "An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half, revealing both the dogs head above water holding a tennis ball in it's mouth, and it's paws paddling underwater.",
"num_images": 1,
"limit_generations": false,
"output_format": "jpeg",
"aspect_ratio": "16:9",
"sync_mode": false
}
Response
{
"request_id": "nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Request Headers
| Header | Value |
|---|---|
| Content-Type | application/json |
| Cache-Control | no-cache |
| Ocp-Apim-Subscription-Key | YOUR_SUBSCRIPTION_KEY |
Response Handling
Common status codes.
| Code | Meaning |
|---|---|
| 202 | Accepted — Request queued |
| 400 | Bad Request |
| 401 | Unauthorized |
| 402 | Insufficient Balance |
| 403 | Forbidden |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Error Responses
Queue system errors and model validation errors.
Queue System Errors
// 402 — Insufficient balance
{
"error": "Insufficient Balance",
"message": "Your wallet does not have enough balance."
}
// 400 — Model not found
{
"error": "Model not found",
"message": "Model 'nano-banana' not found or is disabled"
}
Error via Status/Webhook
{
"request_id": "nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "ERROR",
"model_id": "nano-banana",
"error": "Description of the error",
"output": null
}
Retrieving Results
Poll the universal status endpoint to check progress and retrieve results.
Endpoint
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
cURL Example
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://gateway.pixazo.ai/v2/requests/status/nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Response (Completed)
{
"request_id": "nano-banana_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "COMPLETED",
"model_id": "nano-banana",
"error": null,
"output": {
"media_url": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana_019dxxxx-xxxx/output.ext"
],
"media_type": "application/octet-stream"
},
"created_at": "2026-03-31T10:00:00.000Z",
"updated_at": "2026-03-31T10:00:15.000Z",
"completed_at": "2026-03-31T10:00:15.000Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR |
| model_id | string | Model that processed the request |
| error | string|null | Error message if failed |
| output.media_url | array | URLs to generated media (R2 CDN) |
| output.media_type | string | MIME type of the output |
| created_at | string | When request was created |
| completed_at | string|null | When request completed |
| polling_url | string | Status URL (initial response only) |
Status Values
| Status | Description |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
QUEUED → PROCESSING → COMPLETED
→ FAILED
→ ERROR
Typical Workflow
- Send a generate request to the API endpoint
- Save the
request_idfrom the response - Poll every 5-10 seconds:
GET /v2/requests/status/{request_id} - When
statusis"COMPLETED", download fromoutput.media_url
Tip: Use X-Webhook-URL header to get a callback instead of polling.
Nano Banana Standard Text to Image API Pricing
| Resolution | Price (USD) |
|---|---|
| 1024×1024 (1:1) | $0.06 |
| 1920×1080 (16:9) | $0.1188 |
| 2560×1096 (21:9) | $0.1608 |
| 1800×1200 (3:2) | $0.1236 |
| 1200×1800 (2:3) | $0.1236 |
| 1080×1350 (4:5) | $0.0834 |
| 1250×1000 (5:4) | $0.0714 |
| 1080×1440 (3:4) | $0.0888 |
| 1440×1080 (4:3) | $0.0888 |
| 1080×1920 (9:16) | $0.1188 |
Nano Banana Standard Image to Image (Image Editing — Batch) API Documentation
https://gateway.pixazo.ai/nano-banana-async/v1
Authentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your API subscription key |
Image to Image(Edit Image) - Nano Banana Async API
Request Code
POST https://gateway.pixazo.ai/nano-banana-async/v1/nano-banana-image-to-image
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY
{
"prompt": "Convert to watercolor",
"image_urls": ["https://example.com/image.jpg"]
}
import requests
url = "https://gateway.pixazo.ai/nano-banana-async/v1/nano-banana-image-to-image"
headers = {
"Content-Type": "application/json",
"Cache-Control": "no-cache",
"Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
"prompt": "Convert to watercolor",
"image_urls": ["https://example.com/image.jpg"]
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = 'https://gateway.pixazo.ai/nano-banana-async/v1/nano-banana-image-to-image';
const headers = {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
};
const body = {
prompt: 'Convert to watercolor',
image_urls: ['https://example.com/image.jpg']
};
fetch(url, {
method: 'POST',
headers: headers,
body: JSON.stringify(body)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -v -X POST "https://gateway.pixazo.ai/nano-banana-async/v1/nano-banana-image-to-image" \
-H "Content-Type: application/json" \
-H "Cache-Control: no-cache" \
-H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
--data-raw '{
"prompt": "Convert to watercolor",
"image_urls": ["https://example.com/image.jpg"]
}'
Output
{
"request_id": "nano-banana-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Webhook (Optional)
Add the X-Webhook-URL header to your generate request to receive a POST callback instead of polling.
X-Webhook-URL: https://your-server.com/webhook/callback
Request Parameters - Image to Image(Edit Image)
| Parameter | Required | Type | Description |
|---|---|---|---|
| prompt | Yes | string | Text description of the desired transformation (required) |
| image_urls | Yes | string[] | Array of input image URLs (1-3 images, required) |
| num_images | No | integer | Number of image variations to generate (1-10) |
| aspect_ratio | No | string | Image aspect ratio (see options below) |
| output_format | No | string | Output format: "jpeg", "png", or "webp" |
| resolution | No | string | Image resolution: "1K" or "2K" |
| enable_web_search | No | boolean | Enable Google Search grounding for more accurate results |
| sync_mode | No | boolean | Return base64 data URIs instead of R2 URLs |
| webhook | No | string | Webhook URL for automatic completion notifications |
Example Request
{
"prompt": "Transform into a detailed watercolor painting with soft brush strokes and vibrant colors",
"image_urls": [
"https://example.com/image1.jpg",
"https://example.com/image2.jpg",
"https://example.com/image3.jpg"
],
"num_images": 1,
"aspect_ratio": "21:9",
"output_format": "png",
"resolution": "2K",
"enable_web_search": true,
"sync_mode": false,
"webhook": "https://your-domain.com/api/webhook/gemini"
}
Response
{
"request_id": "nano-banana-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "QUEUED",
"polling_url": "https://gateway.pixazo.ai/v2/requests/status/nano-banana-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
Request Headers
| Header | Value |
|---|---|
| Content-Type | application/json |
| Cache-Control | no-cache |
| Ocp-Apim-Subscription-Key | YOUR_SUBSCRIPTION_KEY |
Response Handling
Common status codes.
| Code | Meaning |
|---|---|
| 202 | Accepted — Request queued |
| 400 | Bad Request |
| 401 | Unauthorized |
| 402 | Insufficient Balance |
| 403 | Forbidden |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Error Responses
Queue system errors and model validation errors.
Queue System Errors
// 402 — Insufficient balance
{
"error": "Insufficient Balance",
"message": "Your wallet does not have enough balance."
}
// 400 — Model not found
{
"error": "Model not found",
"message": "Model 'nano-banana-async-api' not found or is disabled"
}
Error via Status/Webhook
{
"request_id": "nano-banana-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "ERROR",
"model_id": "nano-banana-async-api",
"error": "Description of the error",
"output": null
}
Retrieving Results
Poll the universal status endpoint to check progress and retrieve results.
Endpoint
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
cURL Example
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
"https://gateway.pixazo.ai/v2/requests/status/nano-banana-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Response (Completed)
{
"request_id": "nano-banana-async-api_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "COMPLETED",
"model_id": "nano-banana-async-api",
"error": null,
"output": {
"media_url": [
"https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/nano-banana-async-api_019dxxxx-xxxx/output.ext"
],
"media_type": "application/octet-stream"
},
"created_at": "2026-03-31T10:00:00.000Z",
"updated_at": "2026-03-31T10:00:15.000Z",
"completed_at": "2026-03-31T10:00:15.000Z"
}
Response Fields
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR |
| model_id | string | Model that processed the request |
| error | string|null | Error message if failed |
| output.media_url | array | URLs to generated media (R2 CDN) |
| output.media_type | string | MIME type of the output |
| created_at | string | When request was created |
| completed_at | string|null | When request completed |
| polling_url | string | Status URL (initial response only) |
Status Values
| Status | Description |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
QUEUED → PROCESSING → COMPLETED
→ FAILED
→ ERROR
Typical Workflow
- Send a generate request to the API endpoint
- Save the
request_idfrom the response - Poll every 5-10 seconds:
GET /v2/requests/status/{request_id} - When
statusis"COMPLETED", download fromoutput.media_url
Tip: Use X-Webhook-URL header to get a callback instead of polling.
Nano Banana Standard Image to Image (Image Editing — Batch) API Pricing
| Resolution | Price (USD) |
|---|---|
| 1K | $0.03 |
| 2K | $0.05 |