Verwendung der Nano Banana Pro/Nano Banana 2 API – Schritt-für-Schritt-Anleitung für Entwickler

Wenn Sie nach “Nano Banana Pro API” gesucht haben, ist zunächst einmal der Name verwirrend. Der Produktname lautet Nano Banana Pro. Der Name der API, die Sie tatsächlich im Code verwenden, lautet gemini-3-pro-image. Sobald das geklärt ist, ist der Rest der Einrichtung schon viel weniger rätselhaft.

Verwenden Sie Nano Banana Pro, wenn das Bild ein einheitliches Gesamtbild ergeben muss: lesbarer Text, Produktdetails, Markenbezüge, lokalisierte Layouts oder ein visuelles Briefing mit vielen kleinen Vorgaben. Wenn Sie noch zehn Varianten derselben Idee ausprobieren, beginnen Sie zunächst mit Nano Banana 2 und wechseln Sie zu Pro, sobald sich die Richtung so weit konkretisiert hat, dass es sich lohnt, mehr Zeit und Geld zu investieren.

Wenn Ihr Team noch immer an der Ausarbeitung von Prompts arbeitet, anstatt eine App auf den Markt zu bringen, Der Nano Banana Pro-Arbeitsbereich von GlobalGPT bietet eine praktische Möglichkeit, Ergebnisse zu vergleichen, bevor ein Entwickler die offizielle API implementiert. Es handelt sich um eine kreative Abkürzung im Arbeitsablauf, nicht jedoch um einen Ersatz für die API-Konsole, die Abrechnung, die Protokolle oder die Unternehmenskontrollen von Google.

Kurze Antwort

Um Nano Banana Pro über eine API zu nutzen, erstellen Sie ein Google AI Studio- oder Google Cloud-Projekt, generieren Sie einen Gemini-API-Schlüssel, installieren Sie das Google Gen AI SDK und rufen Sie gemini-3-pro-image. Beginnen Sie mit einer einfachen Text-zu-Bild-Anfrage. Falls Sie den Zugriff noch vor der Erstellung der API überprüfen, dann Anleitung zur kostenlosen Testversion von Gemini 3 Pro ist eine nützliche Begleitlektüre.

Was die Nano Banana Pro-API eigentlich ist

Nano Banana Pro ist Googles natives Premium-Modell zur Bildgenerierung aus der Gemini-Bildfamilie. In der Entwicklerdokumentation bezeichnet Google es als Gemini 3 Pro Bild. Deshalb unterscheidet sich die Modellbezeichnung vom Marketingnamen.

Die API kann aus Text ein Bild generieren, ein oder mehrere Referenzbilder verwenden und ein vorhandenes Bild gemäß schriftlicher Anweisungen bearbeiten. Dadurch eignet sie sich besonders für Produktentwürfe, Anzeigenvarianten, Diagramme, lokalisierte Werbemittel und Bild-Workflows, bei denen der Text im Bild lesbar bleiben muss; für die Erkundung ohne Programmieraufwand bietet die GlobalGPT-Bildgenerator ist der Ort, an dem sich die kreative Ausrichtung am einfachsten zunächst testen lässt.

Nano Banana Pro vs. Nano Banana 2

Bei der Wahl geht es weniger darum, welcher Name moderner klingt, sondern vielmehr darum, in welcher Phase der Arbeit du dich befindest. „Pro“ ist für den sorgfältigen Durchgang gedacht. „Nano Banana 2“ ist für die chaotische Entwurfsrunde gedacht; wenn du diesen schnelleren Weg benötigst, lies den Nano Banana – Leitfaden für die kostenlose Testversion 2 bevor Sie den gesamten Arbeitsablauf auf Pro ausrichten.

Richten Sie die API mit den tatsächlichen Einstiegspunkten ein

Für einen Prototyp ist Google AI Studio in der Regel der schnellste Weg. Für eine Unternehmens-App sollten Sie die Google Cloud-Umgebung nutzen, auf die Ihr Team bereits vertraut – insbesondere, wenn Sie gemeinsame Abrechnung, Zugriffskontrolle, Protokollierung oder Vertex AI-Governance benötigen. Wenn die Entscheidung für oder gegen Google-Tarife im Vordergrund steht, vergleichen Sie die Vor- und Nachteile in der Leitfaden: Google AI Plus vs. Pro bevor man die Einrichtung der API als das einzige Problem betrachtet.

Die öffentliche Dokumentation ist der beste erste Anlaufpunkt. Dort können Sie überprüfen, ob Sie sich auf der Seite zur Erstellung von Nano Banana-Images befinden, feststellen, ob die Seite den empfohlenen Interactions-API-Pfad verwendet, und von dort aus zu den Einstiegspunkten für den API-Schlüssel oder AI Studio springen.

1. Erstellen Sie ein Google AI Studio- oder Google Cloud-Projekt oder öffnen Sie ein bereits vorhandenes.
2. Erstellen Sie einen Gemini-API-Schlüssel.
3. Speichern Sie den Schlüssel als serverseitige Umgebungsvariable.
4. Installieren Sie das Google Gen AI SDK in Ihrem Backend-Projekt.
5. Führen Sie einen Test mit niedriger Auflösung durch, bevor Sie Referenzbilder oder benutzerseitige Funktionen hinzufügen.

Die Seite mit den API-Schlüsseln ist ebenfalls öffentlich zugänglich, doch das Erstellen oder Anzeigen eines Schlüssels hängt von Ihrem Google-Konto und den Projektberechtigungen ab. Das Wichtigste dabei: Halten Sie diesen Schlüssel vom Frontend-JavaScript fern. Ein Browser oder eine mobile App sollte Ihr Backend aufrufen, und Ihr Backend sollte Gemini aufrufen.

Nach der Anmeldung wird die direkte URL von AI Studio tatsächlich im Playground angezeigt, und zwar mit Nano Banane Pro ausgewählt als gemini-3-pro-image. In diesem Bericht wies AI Studio zudem auf eine praktische Einschränkung hin: Für Nano Banana Pro ist ein Google-AI-Tarif oder ein API-Schlüssel erforderlich, bevor der Playground das Programm ausführen kann.

Die Code abrufen Es lohnt sich an dieser Stelle dennoch, die Schaltfläche zu überprüfen. Sie bestätigt, dass Sie sich im Entwickler-Workflow befinden. Sollte das Modell jedoch für das Konto gesperrt sein, öffnet sich das Code-Fenster möglicherweise ohne ein vollständiges, ausführbares Snippet. Dies ist ein Hinweis auf die Konfiguration und kein Fehler der Eingabeaufforderung.

export GEMINI_API_KEY="YOUR_API_KEY"

Ein erstes Bild erstellen

Die erste Anfrage sollte bewusst einfach gehalten werden. Sie überprüfen die Authentifizierung, den Modellzugriff, die Form der Antwort und die Dateiverarbeitung. Aufwändige Prompt-Arbeiten können warten, bis die Leitung frei ist.

from google import genai
from google.genai import types
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=(
 "Erstelle ein klares Produkt-Mockup eines Reisebechers aus Edelstahl"
 "auf einem weißen Schreibtisch. Füge das lesbare Etikett hinzu: MORNING LAB."
    ),
    config=types.GenerateContentConfig(
 response_modalities=["TEXT", "IMAGE"]
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
 print(part.text)
    elif part.inline_data:
 with open("nano-banana-pro-output.png", "wb") as f:
 f.write(part.inline_data.data)

Diese Vorgabe fordert ein einfaches Produkt-Mockup mit gut lesbarem Text. Das gibt dir einen schnellen Einblick in drei Aspekte, die in der Praxis wichtig sind: Realismus des Objekts, Bildkomposition und die Frage, ob das Modell kurzen Text klar und deutlich darstellen kann. Um die Vorgabe anzupassen, ohne die Angaben zu ändern, probiere denselben Auftrag in Der Nano Banana Pro-Arbeitsbereich von GlobalGPT Erstens.

Bilder mit Quellenangaben bearbeiten

Bei der referenzbasierten Bearbeitung zeigt Nano Banana Pro erst richtig, was es kann. Anstatt ein komplett neues Bild von Grund auf anzufordern, gibst du dem Modell ein Bild vor und gibst genau an, was sich ändern darf und was unverändert bleiben muss.

Wenn Sie kein Entwickler sind, betrachten Sie diesen Abschnitt bitte eher als Beispiel für einen Arbeitsablauf und nicht als etwas, das Sie tatsächlich ausführen müssen. Der Dateiname product-reference.png bedeutet einfach “Ihr bestehendes Produktbild”. Wenn Ihre Hauptaufgabe darin besteht, Bildmodelle zu vergleichen, ist der umfassendere Gemini 3 Pro – Vergleichstest der Alternativen kann Ihnen bei der Entscheidung helfen, ob sich der zusätzliche Aufwand für die Einrichtung der Pro-Version lohnt.

from google import genai
from google.genai import types
from PIL import Image
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
reference = Image.open("product-reference.png")

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=[
 reference,
 (
 "Behalte die Form der Tasse, den Henkel und die Platzierung des Logos unverändert. "
            "Ändere den Hintergrund in eine helle Küchenarbeitsplatte, füge warmes Morgenlicht hinzu, "
 "und sorge dafür, dass der gesamte Text scharf und gut lesbar bleibt."
 ),
    ],
    config=types.GenerateContentConfig(response_modalities=["TEXT", "IMAGE"]),
)

Eine gute Bearbeitungsanweisung klingt fast wie Feedback an einen Designer: Behalte das bei, ändere das, verschiebe das Logo nicht, sorge dafür, dass der Text lesbar bleibt. Vage Anweisungen wie “Mach es hochwertiger” führen oft zu vergeblichen Durchläufen, da sie dem Modell zu viel Raum für Spekulationen lassen.

Preisgestaltung und Kostenkontrolle

Nutzen Sie die Preisseite von Google als verlässliche Quelle, bevor Sie feste Budgetzahlen veröffentlichen. Wie am 21. Juli 2026 überprüft wurde, listet Google „Nano Banana Pro“ unter „Gemini 3 Pro Image“ auf und trennt die Kosten für Text/Denkprozesse von den Kosten für die Bildausgabe.

Kosten für die API-Bildausgabe, Stand: 21. Juli 2026

Das praktische Kostenmodell ist einfach: Günstiger entwerfen, sorgfältig fertigstellen. Lassen Sie Nano Banana 2 die ersten Varianten bearbeiten und senden Sie dann die aussagekräftigsten Eingabeaufforderungen und Referenzen an Nano Banana Pro, um die endgültigen Bilder zu erhalten. Begrenzen Sie außerdem die Auflösung je nach Nutzerstufe und vermeiden Sie wiederholte Generierungen, wenn sich die Eingabeaufforderung nicht geändert hat; wenn Sie einen produktseitigen Entwurfsweg wünschen, Nano Banana 2 in GlobalGPT ist die einfachere Variante, die man zuerst ausprobieren sollte.

Anmerkungen zur Produktion

Sobald Nutzer Bilder auf Basis Ihres Produkts generieren können, benötigen Sie Sicherheitsvorkehrungen. Bild-APIs können schnell teuer werden, und Fehler müssen erklärbar sein, ohne dass detaillierte Informationen zum Anbieter preisgegeben werden. Teams, die noch darüber entscheiden, wer kostenpflichtigen KI-Zugang benötigt, können außerdem Abonnement-basierte Arbeitsabläufe im ChatGPT Leitfaden zur Erstellung eines Geschäftsplans.

• Schlüssel serverseitig speichern: Übermitteln Sie den Gemini-API-Schlüssel nicht über einen Browser oder einen mobilen Client.
• Protokolliere genügend Informationen, um das Problem zu beheben: Modell-ID, Prompt-Hash, Ausgabegröße, Latenz, Benutzer-ID und Ergebnisstatus.
• Kontingente festlegen: Anzahl der Bilder pro Benutzer, Arbeitsbereich und Abrechnungszeitraum begrenzen.
• Versuchen Sie es noch einmal sorgfältig: Versuche bei vorübergehenden Fehlern einen erneuten Versuch, aber wiederhole bei Richtlinien- oder Kontingentfehlern den Versuch nicht in einer Schleife.
• Lagerungsregeln festlegen: Erfahren Sie, wie lange Sie erstellte Bilder und hochgeladene Referenzen aufbewahren.
• Schreibe aussagekräftige Fehlermeldungen: Teilen Sie dem Benutzer mit, ob das Problem auf Zugriffsrechte, das Dateiformat, die Kontingentierung oder die Eingabeaufforderungsrichtlinie zurückzuführen ist.

Wo GlobalGPT zum Einsatz kommt

GlobalGPT lässt sich am besten vor oder neben dem API-Build einsetzen. Ein Entwickler kann Nano Banana Pro mit Nano Banana 2, GPT Image, Flux und andere Bildmodelle in einem Arbeitsbereich zusammenführen und anschließend das erfolgreichste Prompt-Muster an den Entwickler weitergeben.

Für offizielle API-Schlüssel, Abrechnungsfragen, Protokolle, Unternehmenszugang oder Vertex AI-Routing sollten Sie die Entwicklerplattform von Google nutzen. Für einen schnelleren Vergleich von Kreativinhalten und weniger Tabs während der Entwicklung von Prompts, Der Arbeitsbereich des Bildgenerators von GlobalGPT kann dazu beitragen, dass die frühen Arbeiten weniger holprig wirken.

FAQ

Ist die Nano Banana Pro API dasselbe wie das Gemini 3 Pro Image?

Für Entwicklerzwecke, ja. Google bezeichnet das Nano Banana Pro als „Gemini 3 Pro Image“, und die API-Modell-ID lautet gemini-3-pro-image.

Sollte ich „Nano Banana Pro“ oder „Nano Banana 2“ verwenden?

Verwenden Sie Nano Banana Pro für endgültige Bilder, bei denen eine genauere Kontrolle, lesbarer Text, Verweise oder Markenkonsistenz erforderlich sind. Verwenden Sie Nano Banana 2 für schnellere Entwürfe und kostengünstigere Iterationen.

Kann ich Nano Banana Pro direkt aus dem Frontend-JavaScript aufrufen?

Nein. Bewahren Sie den API-Schlüssel serverseitig auf, leiten Sie Anfragen über Ihr Backend weiter und wenden Sie Benutzerkontingente an, bevor Sie Anfragen an die Gemini-API senden.

Ersetzt GlobalGPT die offizielle Google-API?

Nr. GlobalGPT eignet sich für schnelle Tests und den Vergleich verschiedener Kreativmodelle, doch offizielle API-Schlüssel, Abrechnungsfunktionen, Protokolle und Unternehmenskontrollen sind Teil der Entwicklerplattform von Google.

Wie kann ich die Kosten für die Nano Banana Pro API abschätzen?

Nutzen Sie die aktuelle Preisseite der Gemini-API von Google und erstellen Sie eine Schätzung nach Modell, Ausgabeauflösung und Bildvolumen. Ein gängiges Verfahren zur Kostenkontrolle besteht darin, zunächst mit dem kostengünstigeren Modell zu entwerfen und anschließend Nano Banana Pro für ausgewählte endgültige Assets zu verwenden.