Kurzantwort
- Der Einstiegspunkt ist POST /v1/images/generations; senden Sie die Bildaufgabe mit der laut Dokumentation gültigen Nano-Banana-2-Modellkennung.
- Unterstützt Text zu Bild per Prompt sowie referenzbildgeführte Generierung über reference_images, geeignet für Werbung, E-Commerce, Social Media und Batch-Kreativinhalte.
- Der Ablauf ist asynchron: Aufgabe senden, Aufgaben-ID erhalten und das Ergebnis anschließend über den Status-Endpoint der Bildaufgabe abfragen.
- Die offiziellen Vergleichspreise liegen bei etwa $0.067 / $0.101 / $0.151 pro Bild für 1K / 2K / 4K; ToAPIs zeigt derzeit $0.030 / $0.040 / $0.060 pro Bild auf der Vergleichsseite, die endgültige Abrechnung richtet sich nach Ihrem Kontopreis.
- Bei der ToAPIs-1K-Rate von $0.030 pro Bild entsprechen $10 Aufladung etwa 333 zusätzlichen 1K-Bildern; bei der 4K-Rate von $0.060 pro Bild etwa 166 4K-Bildern.
Wichtige Parameter
- model | string | erforderlich | nano_banana_2 | - | Verwenden Sie die Nano-Banana-2-Modellkennung aus der ToAPIs-Dokumentation oder der Preistabelle.
- prompt | string | erforderlich | - | - | Haupt-Prompt für die Bildgenerierung.
- size | string | optional | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | Ausgabe-Seitenverhältnis; die verfügbaren Werte richten sich nach Dokumentation und Modellfähigkeit.
- resolution | string | optional | 1K | 1K | 2K | 4K | Auflösungsstufe der Ausgabe; beeinflusst Preis pro Bild und Generierungskosten.
- reference_images | string[] | optional | - | URL-Array | URL-Array mit Referenzbildern für referenzgeführte Generierung und Stil- oder Motivsteuerung.
- response_format | string | optional | url | url | b64_json | Format der Antwort; für die meisten Workflows wird URL empfohlen.
Häufige Fehler
- 400 invalid_request_error: Auslöser=model/prompt fehlt oder Felder für Auflösung, Seitenverhältnis oder Referenzbilder entsprechen nicht der Dokumentation.; Behebung=Prüfen Sie model, prompt, size, resolution und reference_images anhand der ToAPIs-Dokumentation.; Wiederholung=Wiederholen Sie erst nach Korrektur der Parameter; ein blindes Wiederholen ist nicht sinnvoll.
- 401 authentication_error: Auslöser=Authorization-Header fehlt oder der API-Schlüssel ist ungültig.; Behebung=Prüfen Sie das Bearer-Token-Format und die Berechtigungen des Schlüssels.; Wiederholung=Wiederholen Sie nach Korrektur der Authentifizierung.
- 429 rate_limit_exceeded: Auslöser=Anfragefrequenz, Parallelität oder aktuelle Credits stoßen an die Grenze.; Behebung=Wenden Sie exponentiellen Backoff an, senken Sie die Parallelität und prüfen Sie die Konto-Credits.; Wiederholung=Empfohlen ist ein Backoff von 1s/2s/4s mit Jitter; bei wiederholtem Auslösen Anfragen in eine Warteschlange geben.










