Einführung
Nano Banana 2 Text-zu-Bild ist das Gemini 3.1 Flash Image von Google, veröffentlicht am 26. Februar 2026, und erzeugt Bilder aus einem geschriebenen Prompt. Google beschreibt es als Bildqualität auf Pro-Niveau in Flash-Geschwindigkeit. Es rendert in vier Größenstufen von 0.5k bis 4k in vierzehn Formaten bis 8:1 und kann vor dem Zeichnen im Web und nach Referenzbildern suchen, ab deutlich unter den Preisen von Google.
Modus nach dem Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| ein schriftliches Briefing | Nano Banana 2 Text-zu-Bild |
| ein Bild, das geändert werden soll | Nano Banana 2 Bildbearbeitung |
Wichtige Funktionen und Highlights
Economy-Route und Official fallback
Anfragen starten auf einer Economy-Route mit einem Preis deutlich unter dem Listenpreis von Google. Ist Official fallback eingeschaltet (Standard), läuft eine Anfrage, die sie nicht abschließen kann, erneut über die offizielle Route zum offiziellen Preis. In beiden Fällen ist das Modell Gemini 3.1 Flash Image von Google, mit den Größenstufen, die Google für Nano Banana 2 veröffentlicht.
Vier Stufen, vierzehn Formate
Von 512-Pixel-Entwürfen bis zu 4096-Pixel-Endfassungen und von 1:8-Türmen bis zu 8:1-Bannern. Das Format ändert den Preis nie, nur die Größenstufe. In 2k kam unser 4:1-Banner 4128 Pixel breit zurück.
Suche vor dem Zeichnen
Die Websuche holt aktuelle Fakten wie Daten, Wetter und Wahrzeichen; die Bildsuche holt Referenzbilder echter Orte und Produkte. Beide sind optionale Schalter an der Anfrage.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Bis zu 5.000 Zeichen. Beschreiben Sie Motiv, Umgebung, Licht und Objektiv in ganzen Sätzen; Wörter in Anführungszeichen erscheinen als Text im Bild. mindestens 1 Zeichen · höchstens 5000 Zeichen |
aspect_ratio | Nein | Eines von vierzehn Formaten, darunter die extremen Banner 4:1, 1:4, 8:1 und 1:8; standardmäßig 16:9. Das Format ändert den Preis nicht. |
resolution | Nein | 0.5k, 1k (Standard), 2k oder 4k. Ein quadratisches Bild ist 512, 1024, 2048 oder 4096 Pixel breit; jede Stufe hat ihren eigenen Preis. |
enable_web_search | Nein | Standardmäßig aus. Eingeschaltet schlägt das Modell vor dem Zeichnen aktuelle Fakten wie Wetter, Daten oder Wahrzeichen nach. Standardwert: |
enable_image_search | Nein | Standardmäßig aus. Eingeschaltet sucht das Modell vor dem Zeichnen Referenzbilder im Web, nützlich für echte Orte und Produkte. Standardwert: |
official_fallback | Nein | Standardmäßig eingeschaltet. Jede Anfrage läuft zuerst auf der Economy-Route. Standardwert: |
Preis
Abrechnung pro Bild nach Größenstufe; das Seitenverhältnis ändert den Preis nicht. Jede Anfrage startet auf der Economy-Route zum Economy-Preis. Ist Official fallback eingeschaltet (Standard), läuft eine Anfrage, die die Economy-Route ablehnt oder nicht abschließen kann, erneut über die offizielle Route zum offiziellen Preis; das Angebot zeigt daher den Einstiegspreis und den Höchstbetrag. Ausgeschaltet zahlen Sie nur den Economy-Preis. Anfragen in 0.5k oder mit Websuche oder Bildsuche laufen über die offizielle Route, und jede Suche fügt eine Gebühr hinzu. Auf der offiziellen Route gilt eine Ablehnung, die als kurze Textantwort statt als Bild zurückkommt, als abgeschlossene Generierung und wird zum offiziellen Preis berechnet; andere Ablehnungen werden nicht berechnet.
| Spezifikation | Preis |
|---|---|
| $0.036 / Bild |
| $0.0384 / Bild (Mit Official fallback: bis zu $0.0536) |
| $0.0602 / Bild (Mit Official fallback: bis zu $0.0808) |
| $0.0902 / Bild (Mit Official fallback: bis zu $0.1208) |
Anwendungsfälle
Website-Header und Plakatwände
Ultrabreite 4:1- und 8:1-Banner, gerendert als ein durchgehendes Foto, ohne nachträgliches Zusammensetzen oder Strecken.
Schnelle Mode- und Lifestyle-Entwürfe
Viele Richtungen pro Stunde in 0.5k und 1k, die stärkste wird für die Auslieferung in 2k wiederholt.
Echte Orte und Produkte
Mit eingeschalteter Bildsuche können Szenen an einem echten Wahrzeichen oder mit einem echten Produkt auf Referenzbilder aus dem Web zurückgreifen.
Hohe Formate für Mobilgeräte
Hohe 1:4- und 1:8-Bilder für Story-Formate und seitliche Banner, erzeugt als ein durchgehendes Bild.
Prompt-Leitfaden und Praxistipps
Breiten Formaten an beiden Enden Inhalt geben
Beschreiben Sie bei 4:1 und 8:1, was den linken und rechten Rand füllt: ein langer Strand, eine Skyline, eine Reihe Ladenfronten. Sonst werden die Enden zu leerem Himmel.
Suche für Fakten, nicht für Stil
Die Websuche hilft, wenn das Bild von etwas Aktuellem oder Realem abhängt. Stil und Komposition verbessert sie nicht, lassen Sie sie sonst aus.
Klein entwerfen, groß ausliefern
Lassen Sie den Prompt zwischen 0.5k und 4k unverändert; die Komposition bleibt nahe dran, Entscheidungen am Entwurf gelten also weiter.
2k für die Auslieferung wählen
In 2k ist ein quadratisches Bild 2048 Pixel breit, genug für die meisten Bildschirme und Seiten; 4k für Druck und starke Ausschnitte aufheben.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9",
"enable_web_search": false,
"enable_image_search": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
