Anmerkung des Autors: Detaillierte Entwicklungsdokumentation für Nano Banana 2 (gemini-3.1-flash-image-preview). Vergleich zwischen der offiziellen Google API und der APIYI-Plattform mit zwei Integrationslösungen, inklusive vollständiger Codebeispiele, Parameterkonfigurationen und Strategien zur Kostenoptimierung.
Entwickler, die Nano Banana 2 integrieren möchten, können nun auf zwei Dokumentationen zurückgreifen: die offizielle Google-Dokumentation (ai.google.dev/gemini-api/docs/image-generation) und die Dokumentation der APIYI-Plattform (docs.apiyi.com/api-capabilities/nano-banana-2-image).
Beide Ansätze haben ihre Vorteile – die offizielle Dokumentation bietet den vollen Funktionsumfang, während die APIYI-Dokumentation die einfachste Integration und Preise ab $0,03 pro Aufruf bietet. In diesem Artikel vergleichen wir die Kerninhalte beider Dokumente, um Ihnen bei der Wahl der optimalen Integrationsmethode zu helfen.
Kernwert: Nach der Lektüre dieses Artikels beherrschen Sie die vollständigen API-Parameter von Nano Banana 2, kennen die Codebeispiele für beide Integrationslösungen und wissen, welche Option für Ihr Szenario am besten geeignet ist.
Preisvergleich der beiden Nano Banana 2 Optionen
| Modell | Offizieller Standardpreis | Offizieller Batch-Preis | APIYI Preis | APIYI vs. Offiziell |
|---|---|---|---|---|
| Nano Banana 2 | $0,067/Bild (1K) | $0,034/Bild | $0,03/Aufruf | 55% günstiger |
| Nano Banana Pro | $0,134/Bild | $0,067/Bild | $0,05/Aufruf | 63% günstiger |
| Nano Banana (1. Gen) | $0,039/Bild | — | $0,025/Aufruf | 36% günstiger |
Monatlicher Kostenvergleich für Nano Banana 2 (1.000 Bilder pro Tag)
| Option | Monatliche Kosten (1K Auflösung) | Jährliche Kosten |
|---|---|---|
| Offizieller Standard | $2.010 | $24.120 |
| Offizieller Batch | $1.020 | $12.240 |
| APIYI | $900 | $10.800 |
Der Preis von APIYI mit $0,03 pro Aufruf ist nicht nur 55 % günstiger als der offizielle Standardpreis, sondern liegt sogar unter dem halben Batch-Preis ($0,034) – und das bei Echtzeit-Antworten, ohne dass Sie 24 Stunden auf eine asynchrone Verarbeitung warten müssen.
🎯 Spar-Option: Nutzen Sie Nano Banana 2 über APIYI (apiyi.com). 1.000 Bilder pro Tag kosten nur $30, was monatliche Kosten von $900 ergibt. Bei der Registrierung erhalten Sie kostenloses Testguthaben. Ein einziger API-Schlüssel unterstützt Nano Banana 2, Pro und andere gängige Modelle.
Leitfaden für fortgeschrittene Funktionen von Nano Banana 2
Bildbearbeitung in Multi-Turn-Dialogen
Nano Banana 2 unterstützt die kontinuierliche Bearbeitung desselben Bildes innerhalb eines Dialogs:
# APIYI + OpenAI-Format für Multi-Turn-Edits
messages = [
{"role": "user", "content": "Erzeuge ein minimalistisches Markenlogo in Blautönen"},
# Weiterbearbeitung nach der Rückgabe der ersten Runde
{"role": "assistant", "content": "[Ergebnis der ersten Runde]"},
{"role": "user", "content": "Ändere die Farbe in einen violetten Farbverlauf und füge den Firmennamen 'TechFlow' hinzu"}
]
response = client.chat.completions.create(
model="gemini-3.1-flash-image-preview",
messages=messages
)
Referenzbild-Erzeugung mit Nano Banana 2
| Referenztyp | Maximale Anzahl | Verwendungszweck |
|---|---|---|
| Objektreferenz | 10 Bilder | Konsistenz der Objektdetails beibehalten (Produktbilder, Requisiten etc.) |
| Personenreferenz | 4 Bilder | Gesichtskonsistenz beibehalten (Charaktere, virtuelle Avatare etc.) |
| Gesamt | 14 Bilder | Maximal 14 Referenzbilder pro Aufruf |
Auswahl des Thinking-Modus für Nano Banana 2
| Modus | Anwendungsbereich | Geschwindigkeit | Qualität | Zusatzkosten |
|---|---|---|---|---|
| Minimal (Standard) | Tägliche Erzeugung, einfache Szenarien | Schnell | Standard | Wenige Thinking-Token |
| High | Komplexe Kompositionen, präziser Text, Szenarien mit vielen Elementen | Langsamer | Höher | Mehr Thinking-Token |
🎯 Entwickler-Tipp: Thinking-Token verursachen Kosten, unabhängig davon, ob
includeThoughts=truegesetzt ist oder nicht. Wenn Sie den Denkprozess nicht einsehen müssen, belassen Sie es bei der Standardeinstellungfalse– dies beeinträchtigt die Qualität der Bilderzeugung nicht, es wird lediglich der Text des Zwischenschritts nicht zurückgegeben.
Nano Banana 2 Generierungsgeschwindigkeit (Referenz)
| Auflösung | APIYI Gemessene Geschwindigkeit | Beschreibung |
|---|---|---|
| 0.5K | 3–8 Sekunden | Am schnellsten, ideal für schnelle Iterationen |
| 1K (Standard) | 5–10 Sekunden | Gute Erfahrung im täglichen Gebrauch |
| 2K | 10–15 Sekunden | Etwas langsamer, aber akzeptabel |
| 4K | 15–25 Sekunden | Langsamer, 120s Timeout empfohlen |
| High Thinking | Zusätzlich einige Sekunden | Zusätzliche Zeit für die Reasoning-Phase |
Empfehlung: Bei der Verwendung von Nano Banana 2 wird empfohlen,
timeout=300(300 Sekunden) einzustellen, um Zeitüberschreitungen aufgrund von Netzwerkschwankungen oder Google-Rechenleistungsschwankungen zu vermeiden. Über den API-Proxy-Dienst APIYI (apiyi.com) erhalten Sie eine stabilere Verbindung.
Häufig gestellte Fragen (FAQ)
F1: Welche Auflösungen deckt der Preis von 0,03 $ bei APIYI ab?
Der Preis von 0,03 $ pro Aufruf bei APIYI ist ein Einheitspreis, der nicht nach Auflösung unterscheidet. Egal ob Sie Bilder in 0.5K, 1K, 2K oder 4K generieren, die Kosten bleiben bei 0,03 $ pro Aufruf. Im Vergleich zur offiziellen Google-Preisgestaltung, die je nach Auflösung gestaffelt ist (0,045 $ bis 0,151 $), bietet APIYI insbesondere bei 2K- und 4K-Auflösungen einen deutlichen Preisvorteil.
F2: Unterstützt APIYI die Bilderzeugung mit Websuche (Image Search)?
Die Bilderzeugung mit Websuche (Image Search) ist eine erweiterte Funktion von Nano Banana 2, die über das native Google API-Format aufgerufen werden muss. Das native REST-Format von APIYI unterstützt diese Funktion, während das OpenAI-kompatible Format dies derzeit nicht unterstützt. Wenn Ihr Anwendungsszenario Image Search erfordert, empfehlen wir die Nutzung der nativen Aufrufmethode von APIYI.
F3: Was ist der Unterschied zwischen den beiden Dokumentationen und welche sollte ich lesen?
Offizielle Google-Dokumentation (ai.google.dev): Am umfassendsten. Sie enthält detaillierte Erklärungen zu allen Parametern, dem Thinking-Modus, Image Search, Thought Signature und weiteren fortgeschrittenen Funktionen. Ideal für Entwickler, die alle Möglichkeiten des Modells tiefgreifend verstehen möchten.
APIYI-Dokumentation (docs.apiyi.com): Praxisorientierter und prägnanter. Sie konzentriert sich auf eine schnelle Integration und bietet praktische Codebeispiele. Ideal für Entwickler, die Nano Banana 2 schnellstmöglich und kosteneffizient einsetzen wollen. Wir empfehlen, mit der APIYI-Dokumentation zu starten und bei Bedarf die Google-Dokumentation für Spezialfunktionen zu konsultieren.
Zusammenfassung
Die Kernpunkte der Entwicklerdokumentation für Nano Banana 2:
- Zwei Lösungsansätze mit jeweiligen Vorteilen: Die offizielle Google-API bietet den vollen Funktionsumfang (Image Search, Thinking, 14 Referenzbilder), während APIYI den niedrigsten Preis ($0,03/Aufruf) und die einfachste Integration bietet.
- APIYI $0,03 = 45 % des offiziellen Preises: Echtzeit-Antworten, günstiger als der offizielle Batch-Halbpreis ($0,034) und ohne die 24-stündige Wartezeit.
- Universelle Kernparameter: 4 Auflösungsstufen, 14 Seitenverhältnisse, Thinking-Modus und weitere Parameter sind in beiden Lösungen verfügbar.
Für die meisten Entwickler wird der schnelle Zugriff über APIYI (apiyi.com) empfohlen – $0,03 pro Modellaufruf, OpenAI-kompatibles Format, kostenloses Startguthaben bei Registrierung und die erste Bilderzeugung in weniger als 5 Minuten.
📚 Referenzen
-
Offizielle Google Gemini Bilderzeugungs-Dokumentation: Vollständige API-Referenz für Nano Banana 2
- Link:
ai.google.dev/gemini-api/docs/image-generation - Beschreibung: Offizielle Dokumentation für alle Parameter, Funktionen und fortgeschrittenen Features.
- Link:
-
APIYI Nano Banana 2 Dokumentation: Schnelle Integration und Code-Beispiele
- Link:
docs.apiyi.com/api-capabilities/nano-banana-2-image - Beschreibung: Integrationsleitfaden der APIYI-Plattform inklusive Preisgestaltung und Aufrufbeispielen.
- Link:
-
Offizielle Gemini API Preisgestaltung: Exakte Preise für verschiedene Auflösungen
- Link:
ai.google.dev/gemini-api/docs/pricing#gemini-3.1-flash-image-preview - Beschreibung: Standard- und Batch-Preise für 0.5K/1K/2K/4K.
- Link:
-
Gemini API Ratenbegrenzungen (Rate Limits): Aufrufbeschränkungen für Preview-Modelle
- Link:
ai.google.dev/gemini-api/docs/rate-limits - Beschreibung: Informationen zu den Kontingentbeschränkungen für Preview-Modelle.
- Link:
Autor: APIYI Technik-Team
Technischer Austausch: Teilen Sie gerne Ihre Erfahrungen bei der Entwicklung mit Nano Banana 2 im Kommentarbereich. Weitere Informationen zu KI-Modellen finden Sie im Dokumentationszentrum von APIYI unter docs.apiyi.com.
