nano-banana-2.1; ersetze das Modell in URL oder SDK für die anderen beiden.
Verbindung
BetterToken API Key erstellen · Modellkatalog · Nano Banana Modellübersicht
Erstes Bild erzeugen
SetzeBETTERTOKEN_API_KEY im Terminal und führe die Anfrage aus. Sie wartet auf die Generierung und speichert die vollständige JSON-Antwort in response.json.
- macOS / Linux
- Windows PowerShell
imageSize für höhere Auflösung auf 2K oder 4K. Beginne mit 1K, 1:1 und einem Bild. Keine automatischen Wiederholungen per --retry.
Häufige Parameter
Beschreibe für Produktfotos Motiv, Material, Licht und Hintergrund. Gib für Poster den genauen Text und das Layout an. Sage bei Änderungen, was geändert und was beibehalten werden soll. Natives HTTP verwendet diese Felder; das Python SDK nutzt snake_case. Bildoptionen gehören ingenerationConfig.imageConfig.
Von Google unterstützte Seitenverhältnisse
Nano Banana 2 und 2.1 unterstützen 14 Seitenverhältnisse, Pro unterstützt 10. Beginne beim ersten Aufruf mit1:1.
Google-Referenz für Seitenverhältnisse und Bildgrößen
Das Maximum garantiert keine Anzahl. Trotz Mehrfachwunsch kann nur ein Bild zurückkommen. Sende für eine feste Anzahl separate Anfragen.
Antwort lesen und Bilder speichern
Bilder stehen incandidates[].content.parts[].inlineData. Die Struktur unten verwendet den Platzhalter BASE64_IMAGE_DATA. Verarbeite alle endgültigen Bildteile und überspringe thought: true.
mimeType; es kann JPEG statt .png sein.
Vollständiges Python-SDK-Beispiel
Nutze Python ab 3.10 undgoogle-genai==2.30.1. Installiere im virtuellen Projektumfeld; ältere SDK-Versionen können image_size weglassen.
/v1 oder /v1beta. timeout gilt in Millisekunden; attempts=1 deaktiviert automatische Wiederholungen. save_images speichert alle endgültigen Bilder.
Referenzbild senden
Führe dies nach dem Python-Beispiel aus, um eine neue Bearbeitung anzufragen. Ersetzereference.jpg durch deine lokale Datei. Für PNG nutze mime_type="image/png". Weitere Referenzen kommen in parts derselben Nutzernachricht.
inlineData: {"mimeType": "image/jpeg", "data": "BASE64_IMAGE_DATA"}. Kodiere die Originalbytes ohne data:image/...;base64,-Präfix. Kein multipart, Files-Upload oder fileData.
Weiter bearbeiten
Führe dies nach erfolgreicher Generierung oder Referenzbearbeitung aus. Behalte den gesamten Modell-content, die Reihenfolge und thoughtSignature. Baue den Verlauf nicht allein aus dem Bild auf; erfinde oder ändere keine Signaturen.
history, ergänze die Anweisung und dann den Modell-content. previous_interaction_id aus Interactions wird hier nicht verwendet.
API-Unterstützung
- Nutze
generateContentohne Streaming. Files /fileData, Batch, Interactions und Streaming werden hier nicht unterstützt. responseMimeType,responseSchemaund eigene Bildkompressionsformate werden nicht unterstützt. Nutze inimageConfignur die zwei oben aufgeführten Felder.- Lasse
cachedContent, Funktionsaufrufe, Codeausführung, Dateisuche, Maps, URL context sowie Audioeingaben und Einstellungen zur Audioerzeugung weg.
Mit vorhandenem OpenAI-Chat-Client
Du kannstPOST /v1/chat/completions mit Base URL https://bettertoken.ai/v1 aufrufen. Nutze für neue Integrationen, Referenzbilder und mehrere Bearbeitungsschritte die native Gemini-API oben. Lasse in Chat n weg oder setze die Ganzzahl 1.
In HTTP steht google.image_config an der JSON-Wurzel. Im Python OpenAI SDK kommt es in extra_body, das in die Wurzel eingefügt wird. Hier kein generationConfig.
openai==1.66.2 im selben virtuellen Umfeld:
choices[0].message.content, nicht data[] der Images API. Baue aus diesem Text keinen signierten Verlauf auf; verwende native Bearbeitung.
Häufige Fehler
Die Bilder kommen mit der aktuellen Antwort. Dieser Ablauf bietet weder späteren Bildabruf noch Aufgabenabfrage. Ergebnisse sofort speichern, genug Wartezeit in SDK und Proxy zulassen und automatische Wiederholungen deaktivieren.

