Skip to main content
Nutze denselben nativen Gemini-Endpunkt für Textbilder, Referenzbearbeitung und weitere Änderungen. Die Beispiele verwenden nano-banana-2.1; ersetze das Modell in URL oder SDK für die anderen beiden.
Die BetterToken API unterstützt keine Bildgenerierung mit Suche, einschließlich Google Web Search und Image Search grounding. Füge keine Suchwerkzeuge hinzu.

Verbindung

BetterToken API Key erstellen · Modellkatalog · Nano Banana Modellübersicht
Diese drei Modelle unterstützen weder POST /v1/images/generations noch POST /v1/images/edits: Antwort 400 unsupported_endpoint. Übernimm keine GPT-Image-Beispiele mit multipart, image[] oder data[].b64_json.

Erstes Bild erzeugen

Setze BETTERTOKEN_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.
Ändere 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 in generationConfig.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 mit 1: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 in candidates[].content.parts[].inlineData. Die Struktur unten verwendet den Platzhalter BASE64_IMAGE_DATA. Verarbeite alle endgültigen Bildteile und überspringe thought: true.
Dieses Python speichert das curl-Ergebnis. Wähle die Endung anhand von mimeType; es kann JPEG statt .png sein.

Vollständiges Python-SDK-Beispiel

Nutze Python ab 3.10 und google-genai==2.30.1. Installiere im virtuellen Projektumfeld; ältere SDK-Versionen können image_size weglassen.
Die SDK Base URL ist die Domainwurzel ohne /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. Ersetze reference.jpg durch deine lokale Datei. Für PNG nutze mime_type="image/png". Weitere Referenzen kommen in parts derselben Nutzernachricht.
Natives JSON nutzt 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.
Jeder Schritt ist eine neue Generierung. Behalte den gesamten history, ergänze die Anweisung und dann den Modell-content. previous_interaction_id aus Interactions wird hier nicht verwendet.

API-Unterstützung

  • Nutze generateContent ohne Streaming. Files / fileData, Batch, Interactions und Streaming werden hier nicht unterstützt.
  • responseMimeType, responseSchema und eigene Bildkompressionsformate werden nicht unterstützt. Nutze in imageConfig nur 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 kannst POST /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.
Installiere für das Python-OpenAI-SDK-Beispiel openai==1.66.2 im selben virtuellen Umfeld:
Chat liefert Markdown Data URLs in 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.

Offizielle Quellen