Was ist neu in der Nano Banana 2 API auf Emix.ai?

`nano-banana-2` akzeptiert Prompts mit bis zu 20.000 Zeichen, bis zu 14 Referenzbilder (insgesamt max. 30 MB über JPEG/PNG/WebP), 14 Seitenverhältnisse plus `auto` sowie drei Auflösungsstufen (`1K`, `2K`, `4K`) mit PNG- oder JPG-Ausgabe – alles über `POST https://api.emix.ai/api/v1/client/tasks`.

Wie unterscheidet sich Nano Banana 2 vom Vorgänger?

Die vorherige Modell-ID war `nano-banana`; die neue ID lautet `nano-banana-2`. Nano Banana 2 erhöht das Prompt-Limit auf 20.000 Zeichen, unterstützt bis zu 14 Referenzbilder, bietet 14 Seitenverhältnisse (darunter `8:1`, `4:1` und `21:9`) und fügt die `4K`-Auflösungsstufe hinzu. Weitere Details findest du in der Parametertabelle oben und in der vollständigen Referenz unter docs.emix.ai/market/google/nanobanana2.

Wie viele Referenzbilder kann ich in einem Aufruf senden?

Bis zu 14 Bilder über `input.image_input` mit einer Gesamtgröße von 30 MB. Akzeptierte Formate sind JPEG, PNG und WebP.

Unterstützt Nano Banana 2 Audio oder Lip-Sync?

Nein. Nano Banana 2 ist ein Bildgenerierungsmodell (Text-zu-Bild und referenzbasierte Bildbearbeitung). Es erzeugt keine Audio- oder Videoausgaben.

Welche Auflösungen und Seitenverhältnisse sind verfügbar?

`input.resolution` akzeptiert `1K`, `2K` oder `4K` (Standard: `1K`). `input.aspect_ratio` akzeptiert `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` oder `auto` (Standard).

Welche Ausgabeformate gibt die API zurück?

`png` oder `jpg`, festgelegt über `input.output_format` (Standard: `jpg`).

Wo kann ich Nano Banana 2 vor der Integration kostenlos testen?

Nutze die In-Browser-Demo unter emix.ai/models/nano-banana-2 und anschließend den Playground mit allen Parametern unter emix.ai/playground/nano-banana-2. Jedes Feld im Playground entspricht direkt einem API-Parameter.

Wie integriere ich die API in meine App?

Senden Sie einen POST-Request an `https://api.emix.ai/api/v1/client/tasks` mit `Authorization: Bearer YOUR_API_KEY` und einem JSON-Body, der `model: "nano-banana-2"` sowie Ihr `input`-Objekt enthält. Die API gibt `data.taskId` zurück; fragen Sie den 'Get Task Details'-Endpunkt regelmäßig ab oder legen Sie eine `callBackUrl` fest, um das Ergebnis per Webhook zu erhalten. Ausführbare Code-Beispiele für cURL, Python und Node.js finden Sie in Abschnitt 5.

Wie viel kostet die Nutzung?

Nano Banana 2 wird über das Guthaben Ihres Emix.ai-Kontos abgerechnet – eine `402 insufficient credits`-Antwort bedeutet, dass es Zeit ist, Ihr Guthaben aufzuladen. Die aktuellen Preise finden Sie auf der Emix.ai-Preisseite (emix.ai/pricing) sowie unter docs.emix.ai/market/google/nanobanana2.

Welche Statuscodes sollte ich behandeln?

`200` Erfolgreich, `401` Nicht autorisiert, `402` Unzureichendes Guthaben, `404` Nicht gefunden, `422` Validierungsfehler, `429` Ratenlimit überschritten, `433` Sub-Key-Limit erreicht, `455` Dienst nicht verfügbar, `500` Serverfehler, `501` Generierung fehlgeschlagen, `505` Funktion deaktiviert.

Ist der Task synchron?

Nein – die Anfrage gibt sofort eine `taskId` zurück. Rufen Sie das fertige Bild über den einheitlichen 'Get Task Details'-Endpunkt ab oder empfangen Sie es direkt über Ihren `callBackUrl`-Webhook.

README.md

Nano Banana 2 API – 4K-Bilder mit bis zu 14 Referenzen auf Emix.ai generieren

Nutze die Nano Banana 2 (Gemini 3.1 Flash Image) API von Google auf Emix.ai, um einen Prompt – und bis zu 14 Referenzbilder – in ein gestochen scharfes PNG oder JPG in 1K, 2K oder 4K zu verwandeln. Ein Endpunkt, ein Bearer-Key, eine asynchrone taskId. Teste es kostenlos im Playground und übernimm denselben Aufruf direkt in die Produktion. Jetzt live auf Emix.ai. POST https://api.emix.ai/api/v1/client/tasks mit Modell: "nano-banana-2". Vollständige API-Referenz: docs.emix.ai/market/google/nanobanana2.

Im Playground ausprobieren Doku lesen

Release & API-Verfügbarkeit

Die Nano Banana 2 API ist ab sofort auf Emix.ai verfügbar. Nano Banana 2 ist Googles neuestes Text-to-Image- und Bildbearbeitungsmodell – veröffentlicht als Gemini 3.1 Flash Image. Die Model-ID nano-banana-2 lässt sich über den zentralen Emix.ai Task-Endpoint aufrufen, mit derselben Bearer-Authentifizierung, demselben asynchronen Task-Muster und demselben Polling-Ablauf für Task-Details wie der restliche Emix.ai-Katalog – kein separates SDK, keine Warteliste.Wenn du bereits einen Emix.ai-Key besitzt, kannst du nano-banana-2 noch heute aufrufen – ganz ohne Anpassungen an der Integration.

Anbieter & Modell-ID

Anbieter: Google. Modell-ID: nano-banana-2.

Endpunkt & Auth

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

Verarbeitung

Asynchron – die Anfrage gibt eine taskId zurück, die Ergebnisse werden über den 'Get Task Details'-Endpunkt abgerufen oder per Push an deinen callBackUrl-Webhook gesendet.

Doku

docs.emix.ai/market/google/nanobanana2

Playground

emix.ai/playground/nano-banana-2

Verfügbarkeit

Jetzt live auf Emix.ai. Bestehende Emix.ai-API-Keys können nano-banana-2 ab sofort ohne Code-Änderungen aufrufen.

Hauptfunktionen der Nano Banana 2 API

Die Nano Banana 2 API auf Emix.ai macht die gesamte Bildgenerierungs-Oberfläche des Modells über einen einzigen POST-Request zugänglich. Jeder der unten genannten Parameter wird von der Live-API strikt durchgesetzt.

Text-to-Image mit optionaler Referenzbearbeitung

Übergib input.prompt allein für reine Text-to-Image-Generierung, oder hänge über input.image_input bis zu 14 Referenzbilder für Bildbearbeitung, Style-Transfer, Charakterkonsistenz oder Multi-Referenz-Kompositionen an. Der kombinierte Referenz-Payload darf über JPEG-, PNG- oder WebP-Dateien hinweg insgesamt bis zu 30 MB betragen.

Lange, ausdrucksstarke Prompts

input.prompt akzeptiert bis zu 20.000 Zeichen – genug Platz für detaillierte Szenenbeschreibungen, Markenrichtlinien oder Shotlists, ohne dass Texte abgeschnitten werden.

14 Seitenverhältnisse + auto

Wähle aus 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 oder auto (Standard). Quadratische Posts, vertikale Reels, Ultrawide-Banner und Panorama-Streifen werden alle nativ unterstützt.

Drei Auflösungsstufen

input.resolution ist 1K, 2K oder 4K (Standard 1K). Wähle 4K für Print, Hero-Shots und Produktfotografie; 1K für Thumbnails und schnelle Iterationen.

PNG- oder JPG-Ausgabe

input.output_format ist png oder jpg (Standard: jpg). PNG für transparenzempfindliche Workflows und verlustfreies Review, JPG für kleinere Dateigrößen.

Async-by-Design mit Webhooks

Aufgabe senden, sofort eine taskId erhalten und entweder den Endpunkt für Task-Details abfragen oder eine callBackUrl festlegen, damit Emix.ai die fertige Aufgabe per POST an Ihren Server sendet.

Vorhersehbare Fehlercodes

401 unautorisiert, 402 unzureichende Credits, 422 Validierung, 429 Rate-Limit, 433 Sub-Key-Limit, 455 Dienst nicht verfügbar, 500 Serverfehler, 501 Generierung fehlgeschlagen, 505 Funktion deaktiviert — einfach auf Ihre Retry-Logik abzubilden.

Warum Emix.ai für die Nano Banana 2 API

Ein Key, ein Endpunkt, jedes Modell

Die gleiche Route https://api.emix.ai/api/v1/client/tasks führt Nano Banana 2 und den restlichen Emix.ai-Katalog aus. Wechseln Sie Modelle durch das Ändern eines einzigen Strings.

Async-Tasks + Webhooks integriert

callBackUrl ist ein First-Class-Feld. Kein Glue-Code, keine benutzerdefinierte Queue.

Kostenloser Playground für Prompt-Iteration

Passen Sie Prompts, Seitenverhältnis, Auflösung und Referenzen unter emix.ai/playground/nano-banana-2 an, bevor Sie auch nur eine Zeile Code schreiben – exakt dieselben Parameter werden an die API übergeben.

Transparente Dokumentation

Jeder Parameter, jeder Statuscode und jedes Limit wird unter docs.emix.ai/market/google/nanobanana2 veröffentlicht.

Credit-basierte Abrechnung

Ein einziges Kontoguthaben deckt Nano Banana 2 sowie alle anderen Modelle ab – ganz ohne modellspezifische Verträge.

Nano Banana 2 API vs. Vorgängerversion

Das bisherige Nano Banana auf Emix.ai etablierte den Multi-Reference-Workflow. Nano Banana 2 erweitert die Parameteroberfläche, die die API heute tatsächlich akzeptiert. Der Upgrade-Pfad ist eine einzeilige Änderung: Tauschen Sie "model": "nano-banana" gegen "model": "nano-banana-2" aus, und Sie können sofort das größere Prompt-Fenster, die breitere Auswahl an Seitenverhältnissen, 4K-Ausgabe und bis zu 14 Referenzen nutzen.

Schnellstart

Vier Schritte von der Idee zum produktiven API-Aufruf.

Schritt 1 – Online-Test

Öffnen Sie die Modellseite unter emix.ai/models/nano-banana-2 und führen Sie eine One-Shot-Generierung direkt im Browser aus. Für die Demo ist kein Schlüssel erforderlich.

Schritt 2 – Playground

Wechseln Sie zum Nano Banana 2 Playground (emix.ai/playground/nano-banana-2), um Prompt, aspect_ratio, resolution, output_format und Referenzbilder Seite an Seite zu iterieren. Jedes Steuerelement im Playground entspricht 1:1 dem gleichnamigen API-Feld.

Schritt 3 – API-Zugang einrichten

Erstellen Sie ein Emix.ai-Konto oder melden Sie sich an, generieren Sie einen API-Schlüssel im Dashboard und bestätigen Sie Ihr Guthaben. Der gleiche Schlüssel funktioniert für jedes Modell im Emix.ai-Katalog.

Schritt 4 – Erste Anfrage senden

Sende einen Task mit nano-banana-2 ab. Die API gibt eine taskId zurück; frage den 'Get Task Details'-Endpunkt regelmäßig ab oder warte auf den Webhook der callBackUrl.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);

Eine erfolgreiche Übermittlung gibt Folgendes zurück:json{ "code": 200, "msg": "success", "data": { "taskId": "string" } }Verwende die taskId mit dem einheitlichen 'Get Task Details'-Endpunkt, um das fertige Bild abzurufen.

Was kannst du mit der Nano Banana 2 API bauen?

Markenkonsistente Kampagnenbilder

Übergeben Sie ein Logo, eine Modellaufnahme und eine Farbreferenz (insgesamt bis zu 14 Bilder, 30 MB) und weisen Sie Nano Banana 2 per Prompt an, markengerechte Poster in 4K zu generieren.

Skalierbare Produktfotografie

Nutze 4:5 oder 1:1 in 2K–4K für Katalog- und Marktplatz-Listings; wechsle bei output_format zu png, wenn du ein sauberes, alpha-freies Lieferformat für das Design-Review benötigst.

Vertical short-form creative

9:16 in 1K oder 2K für Reels, Shorts und Stories, asynchron generiert und über callBackUrl bereitgestellt.

Ultrabreite Hero-Banner und Panoramen

21:9, 8:1 und 4:1 eignen sich für Landingpage-Heroes, Werbebanner und kinoreife Stills.

Referenzbasierte Charakter- & Stilkonsistenz

Mit bis zu 14 Referenzen kannst du einen Charakter, eine Umgebung und eine Beleuchtungsreferenz in einem einzigen Aufruf fixieren.

Redaktionelle Illustrationen & Comics

Das Kontingent von 20.000 Zeichen pro Prompt bietet ausreichend Platz für detaillierte Panel-Skripte und Szenennotizen.

Bulk-Asset-Pipelines

Reihe tausende Tasks in die Warteschlange ein; lass den callBackUrl-Webhook deinen Storage-Worker benachrichtigen, sobald jedes Bild fertig ist.

Nano Banana 2 API

4.9/ 5

128 ratings

Tap a star to rate