What's new in the Nano Banana 2 API on Emix.ai?

`nano-banana-2` accepts prompts up to 20,000 characters, up to 14 reference images (30 MB total across JPEG/PNG/WebP), 14 aspect ratios plus `auto`, and three resolution tiers (`1K`, `2K`, `4K`) with PNG or JPG output — all through `POST https://api.emix.ai/api/v1/client/tasks`.

How is Nano Banana 2 different from the previous Nano Banana?

The previous model id was `nano-banana`; the new id is `nano-banana-2`. Nano Banana 2 raises the prompt cap to 20,000 chars, supports up to 14 reference images, exposes 14 aspect ratios including `8:1`, `4:1`, and `21:9`, and adds the `4K` resolution tier. See the parameter table above and the full reference at docs.emix.ai/market/google/nanobanana2.

How many reference images can I send in one call?

Up to 14 images via `input.image_input`, with a combined payload of 30 MB. Accepted formats are JPEG, PNG, and WebP.

Does Nano Banana 2 support audio or lip-sync?

No. Nano Banana 2 is an image-generation model (text-to-image and reference-based image editing). It does not produce audio or video output.

What resolutions and aspect ratios are available?

`input.resolution` accepts `1K`, `2K`, or `4K` (default `1K`). `input.aspect_ratio` accepts `1:1`, `1:4`, `1:8`, `2:3`, `3:2`, `3:4`, `4:1`, `4:3`, `4:5`, `5:4`, `8:1`, `9:16`, `16:9`, `21:9`, or `auto` (default).

What output formats does the API return?

`png` or `jpg`, set via `input.output_format` (default `jpg`).

Where can I test Nano Banana 2 for free before integrating?

Use the in-browser demo on emix.ai/models/nano-banana-2, then the full-parameter Playground at emix.ai/playground/nano-banana-2. Every Playground field maps directly to an API parameter.

How do I integrate the API into my app?

Send a `POST` to `https://api.emix.ai/api/v1/client/tasks` with `Authorization: Bearer YOUR_API_KEY` and a JSON body containing `model: "nano-banana-2"` and your `input` object. The API returns `data.taskId`; poll the Get Task Details endpoint or set `callBackUrl` to receive the result via webhook. Runnable cURL, Python, and Node.js samples are in Section 5.

How much does it cost?

Nano Banana 2 is billed from your Emix.ai account credit balance — a `402 insufficient credits` response means it's time to top up. Current credit rates are published on the Emix.ai pricing page (emix.ai/pricing) and at docs.emix.ai/market/google/nanobanana2.

What status codes should I handle?

`200` success, `401` unauthorized, `402` insufficient credits, `404` not found, `422` validation error, `429` rate limited, `433` sub-key limit, `455` service unavailable, `500` server error, `501` generation failed, `505` feature disabled.

Is the task synchronous?

No — submission returns a `taskId` immediately. Retrieve the finished image from the unified Get Task Details endpoint or receive it on your `callBackUrl` webhook.

README.md

Nano Banana 2 API — Generate 4K Images with Up to 14 References on Emix.ai

Run Google's Nano Banana 2 (Gemini 3.1 Flash Image) API on Emix.ai to turn a prompt — and up to 14 reference images — into a clean PNG or JPG at 1K, 2K, or 4K. One endpoint, one Bearer key, one async taskId. Test it free in the Playground, then ship the same call to production. Live now on Emix.ai. POST https://api.emix.ai/api/v1/client/tasks with model: "nano-banana-2". Full reference: docs.emix.ai/market/google/nanobanana2.

Try in Playground Read the Docs

Release & API Availability

The Nano Banana 2 API is available now on Emix.ai. Nano Banana 2 is Google's latest text-to-image and image-editing model — released as Gemini 3.1 Flash Image. The model id nano-banana-2 is callable from the unified Emix.ai task endpoint, with the same Bearer auth, the same async task pattern, and the same Get Task Details polling flow as the rest of the Emix.ai catalog — no separate SDK, no waitlist.If you already have an Emix.ai key, you can call nano-banana-2 today — no integration changes required.

Vendor & Model id

Vendor: Google. Model id: nano-banana-2.

Endpoint & Auth

Endpoint: POST https://api.emix.ai/api/v1/client/tasks. Auth: Authorization: Bearer YOUR_API_KEY.

Processing

Asynchronous — the request returns a taskId, results are retrieved from the Get Task Details endpoint or pushed to your callBackUrl webhook.

Docs

docs.emix.ai/market/google/nanobanana2

Playground

emix.ai/playground/nano-banana-2

Availability

Live now on Emix.ai. Existing Emix.ai keys can call nano-banana-2 today with no integration changes.

Key Features of the Nano Banana 2 API

The Nano Banana 2 API on Emix.ai exposes the model's full image-generation surface through a single POST. Every parameter below is enforced by the live API.

Text-to-image, with optional reference editing

Send input.prompt on its own for pure text-to-image, or attach up to 14 reference images via input.image_input for editing, style transfer, character consistency, or multi-reference composition. The combined reference payload can total up to 30 MB across JPEG, PNG, or WebP files.

Long, expressive prompts

input.prompt accepts up to 20,000 characters — enough room for detailed scene briefs, brand guidelines, or shot lists without truncation.

14 aspect ratios + auto

Choose from 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, or auto (default). Square posts, vertical reels, ultrawide banners, and panorama strips are all first-class.

Three resolution tiers

input.resolution is 1K, 2K, or 4K (default 1K). Pick 4K for print, hero shots, and product photography; 1K for thumbnails and fast iteration.

Async-by-design with webhooks

Submit the task, get a taskId back instantly, and either poll the Get Task Details endpoint or set callBackUrl so Emix.ai POSTs the completed task to your server.

Predictable error codes

401 unauthorized, 402 insufficient credits, 422 validation, 429 rate limited, 433 sub-key limit, 455 service unavailable, 500 server error, 501 generation failed, 505 feature disabled — easy to map to your retry logic.

Why Choose Emix.ai for the Nano Banana 2 API

One key, one endpoint, every model

The same https://api.emix.ai/api/v1/client/tasks route runs Nano Banana 2 and the rest of the Emix.ai catalog. Switch models by changing one string.

Async tasks + webhooks built in

callBackUrl is a first-class field. No glue code, no custom queue.

Free Playground for prompt iteration

Tune prompts, aspect ratio, resolution, and references at emix.ai/playground/nano-banana-2 before you write a line of code — the exact same parameters ship to the API.

Transparent docs

Every parameter, every status code, every limit is published at docs.emix.ai/market/google/nanobanana2.

Credit-based billing

A single account credit balance covers Nano Banana 2 alongside every other model — no per-model contracts.

Nano Banana 2 API vs the Previous Generation

The previous Nano Banana on Emix.ai established the multi-reference workflow. Nano Banana 2 expands the parameter surface that the API actually accepts today. The upgrade path is a one-line change: swap "model": "nano-banana" for "model": "nano-banana-2" and you can immediately use the larger prompt window, the wider aspect-ratio set, 4K output, and up to 14 references.

Quick Start

Four steps from idea to production call.

Step 1 — Online Test

Open the model page at emix.ai/models/nano-banana-2 and run a one-shot generation directly in the browser. No key required for the demo.

Step 2 — Playground

Move to the Nano Banana 2 Playground (emix.ai/playground/nano-banana-2) to iterate on prompt, aspect_ratio, resolution, output_format, and reference images side-by-side. Every control in the Playground maps 1:1 to the API field of the same name.

Step 3 — Get API Access

Create or sign in to your Emix.ai account, generate an API key from the dashboard, and confirm your credit balance. The same key works for every model in the Emix.ai catalog.

Step 4 — Send Your First Request

Submit a task with nano-banana-2. The API returns a taskId; poll the Get Task Details endpoint or wait for the callBackUrl webhook.cURL:bash

curl -X POST https://api.emix.ai/api/v1/client/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "Comic poster: cool banana hero in shades leaps from a sci-fi launch pad",
      "image_input": [],
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "output_format": "png"
    }
  }'

Python:python

import requests

resp = requests.post(
    "https://api.emix.ai/api/v1/client/tasks",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "nano-banana-2",
        "callBackUrl": "https://your-domain.com/api/callback",
        "input": {
            "prompt": "Editorial product shot of a ceramic mug on stone, soft window light",
            "image_input": [],
            "aspect_ratio": "4:5",
            "resolution": "4K",
            "output_format": "jpg",
        },
    },
)

task_id = resp.json()["data"]["taskId"]
print("taskId:", task_id)

Node.js:js

const res = await fetch("https://api.emix.ai/api/v1/client/tasks", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "nano-banana-2",
    callBackUrl: "https://your-domain.com/api/callback",
    input: {
      prompt: "Isometric icon set, 8 items, pastel palette, soft shadows",
      image_input: [],
      aspect_ratio: "1:1",
      resolution: "1K",
      output_format: "png",
    },
  }),
});

const { data } = await res.json();
console.log("taskId:", data.taskId);

A successful submission returns:json{ "code": 200, "msg": "success", "data": { "taskId": "string" } }Use the taskId with the unified Get Task Details endpoint to retrieve the finished image.

What Can You Build with the Nano Banana 2 API

Brand-consistent campaign art

Pass a logo, a model shot, and a color reference (up to 14 images total, 30 MB) and prompt Nano Banana 2 to compose on-brand posters at 4K.

Product photography at scale

Use 4:5 or 1:1 at 2K–4K for catalog and marketplace listings; switch output_format to png when you need a clean alpha-free deliverable for design review.

Vertical short-form creative

9:16 at 1K or 2K for reels, shorts, and stories, generated asynchronously and delivered via callBackUrl.

Ultra-wide hero banners and panoramas

21:9, 8:1, and 4:1 cover landing-page heroes, banner ads, and cinematic stills.

Reference-driven character & style consistency

Up to 14 references let you lock a character, an environment, and a lighting reference in a single call.

Editorial illustration & comics

The 20,000-character prompt budget is large enough for detailed panel scripts and shot notes.

Bulk asset pipelines

Queue thousands of tasks; let the callBackUrl webhook notify your storage worker the moment each image is ready.

Nano Banana 2 API

4.9/ 5

128 ratings

Pick a reaction