Nano Banana Image API

Overview

Model: Nano Banana (powered by Google); supports text-to-image and up to 10 reference images.
Smart mode selection: automatically chooses optimal generation mode based on inputs.
Aspect ratios: 1:1, 16:9, 9:16, 21:9, and more.
Output: png / jpeg (default png).
Async API: submit POST https://api.wizzx.ai/api/v1/task/submit/nano-banana, poll POST https://api.wizzx.ai/api/v1/task/status.

Auth

Authorization: Bearer <your_api_key>

Submit job

Endpoint: POST https://api.wizzx.ai/api/v1/task/submit/nano-banana, Content-Type: application/json

Field	Type	Required	Default/Limit	Description
`prompt`	string	Yes	≤5000 UTF-8 bytes	Text prompt
`image_urls`	array<string>	No	Max 10	Reference images (JPEG/PNG/WebP)
`aspect_ratio`	string	No	Default `1:1`	`1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`, `auto`
`output_format`	string	No	Default `png`	`png` / `jpeg`

Example (text-to-image)

curl -X POST https://api.wizzx.ai/api/v1/task/submit/nano-banana \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A surreal painting of a giant banana floating in space",
    "aspect_ratio": "16:9",
    "output_format": "png"
  }'

Example (image-to-image)

curl -X POST https://api.wizzx.ai/api/v1/task/submit/nano-banana \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Transform this into a watercolor painting style",
    "image_urls": ["https://example.com/reference.jpg"],
    "aspect_ratio": "1:1",
    "output_format": "png"
  }'

Success response:

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "4bbbc9e0-8de8-4f35-a31e-8596c1a6d18a",
    "model_key": "nano-banana",
    "credits_deducted": 24
  },
  "request_id": "d54c66a8-0f0f-439c-bd3a-36f3fd275881"
}

Query status

Endpoint: POST https://api.wizzx.ai/api/v1/task/status

{
  "task_id": "4bbbc9e0-8de8-4f35-a31e-8596c1a6d18a"
}

Response (succeeded):

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "4bbbc9e0-8de8-4f35-a31e-8596c1a6d18a",
    "status": "SUCCEEDED",
    "result_urls": ["https://cdn.example.com/images/result.png"],
    "error": "",
    "credits_deducted": 24
  },
  "request_id": "499347b1-ff99-4ba2-a977-ad655431919d"
}

Client-visible states: PENDING, QUEUED, PROCESSING, REVIEW_REQUIRED, SUCCEEDED, and FAILED. See the task status API reference.

Pricing

Model	Credits	USD
Nano Banana	24	$0.024

Fixed pricing: 24 credits per generation (1000 credits = $1).

Nano Banana vs Nano Banana Pro

Feature	Nano Banana	Nano Banana Pro
Provider	Google	Google
Max Input Images	10	8
Resolution Options	Standard	1K / 2K / 4K
Credits	24 (fixed)	108 / 108 / 144 (1K / 2K / 4K)
Best For	General use, smart mode	High-resolution output

Best practices

Write prompts with subject, scene, lighting, style (e.g., photorealistic, digital art).
Use 1-3 reference images for best results; more images may dilute the effect.
Choose aspect ratio for target surface: 9:16 for portrait, 16:9/21:9 for landscape, 1:1 for covers.
For high-resolution needs (4K), consider using Nano Banana Pro instead.

Getting started

Agent integrations

Video Generation

Image Generation

Nano Banana Image API

Overview

Auth

Submit job

Example (text-to-image)

Example (image-to-image)

Query status

Pricing

Nano Banana vs Nano Banana Pro

Best practices

​Overview

​Auth

​Submit job

​Example (text-to-image)

​Example (image-to-image)

​Query status

​Pricing

​Nano Banana vs Nano Banana Pro

​Best practices

Overview

Auth

Submit job

Example (text-to-image)

Example (image-to-image)

Query status

Pricing

Nano Banana vs Nano Banana Pro

Best practices