Nano Banana API (Gemini 2.5 Flash Image)

Model Guide

About Nano Banana

Fast, efficient image generation and conversational editing for high-volume creative workflows.

1 credit = $0.001 USD. The final deduction returned by the API is authoritative.

Integrate the Nano Banana API (Gemini 2.5 Flash Image)

Every request is asynchronous: submit the task, keep the task ID, then poll for the result. The body below uses the model's default settings.

1. 1

   Get a Nano Banana API (Gemini 2.5 Flash Image) key

   Sign in and create a key in the dashboard. Set WIZZX_API_KEY in your server environment; never expose it in browser code.

2. 2

   Submit a task

   Send a POST request to the model endpoint. A successful submission returns data.task_id; keep that ID before polling. Submission is not generation completion.

3. 3

   Retrieve the result

   Replace YOUR_TASK_ID with the returned ID and query /api/v1/task/status. Wait for SUCCEEDED and read the output URLs. Stop on FAILED or REVIEW_REQUIRED; do not automatically resubmit an uncertain task.

curl -X POST \
  https://api.wizzx.ai/api/v1/task/submit/nano-banana \
  -H "Authorization: Bearer $WIZZX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspect_ratio": "1:1",
  "prompt": "A ceramic coffee cup on a wooden table, soft morning light, product photography"
}'

const response = await fetch("https://api.wizzx.ai/api/v1/task/submit/nano-banana", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WIZZX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "aspect_ratio": "1:1",
    "prompt": "A ceramic coffee cup on a wooden table, soft morning light, product photography"
  }),
});

const payload = await response.json();
const task = payload.data ?? payload;
const taskId = task.task_id;

import os
import requests

response = requests.post(
    "https://api.wizzx.ai/api/v1/task/submit/nano-banana",
    headers={
        "Authorization": f"Bearer {os.environ['WIZZX_API_KEY']}",
    },
    json={
        "aspect_ratio": "1:1",
        "prompt": "A ceramic coffee cup on a wooden table, soft morning light, product photography"
    },
)
payload = response.json()
task = payload.get("data", payload)
task_id = task["task_id"]

curl -X POST \
  https://api.wizzx.ai/api/v1/task/status \
  -H "Authorization: Bearer $WIZZX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "task_id": "YOUR_TASK_ID"
}'

const response = await fetch("https://api.wizzx.ai/api/v1/task/status", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WIZZX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ task_id: "YOUR_TASK_ID" }),
});

const payload = await response.json();
const task = payload.data ?? payload;

import os
import requests

response = requests.post(
    "https://api.wizzx.ai/api/v1/task/status",
    headers={
        "Authorization": f"Bearer {os.environ['WIZZX_API_KEY']}",
    },
    json={"task_id": "YOUR_TASK_ID"},
)
payload = response.json()
task = payload.get("data", payload)

API integration questions

How much does the Nano Banana API (Gemini 2.5 Flash Image) cost?

On Wizzx the Nano Banana API (Gemini 2.5 Flash Image) starts at $0.024/image (24 credits). Each tier above lists its parameters and billing unit, and failed tasks are refunded.

What is the Nano Banana API (Gemini 2.5 Flash Image) model ID?

nano-banana. Submit tasks to POST /api/v1/task/submit/nano-banana with your API key.

Am I charged if a task fails?

No. Credits are reserved when you submit a task and refunded if it fails. You are only charged for successful tasks.

Can I try the Nano Banana API (Gemini 2.5 Flash Image) for free?

Yes. New accounts start with $0.20 in free credits, about 8 images at the starting price.

Is this the official Nano Banana API (Gemini 2.5 Flash Image)?

No. Nano Banana models are developed by Google. Wizzx is an independent API platform that gives you access to them with one API key, an asynchronous task API and pay-as-you-go credits.

Does the submit response contain the generated file?

Generation is asynchronous. The submit response identifies the task. Query its status until it finishes, then use the output URLs in the result. See the API reference for response fields and error handling.

Compare related models