Gemini API: Schritt-für-Schritt-Anleitung für den Wechsel von Imagen zu Nano Banana

Was erfahren Sie in dieser Anleitung?

Laut der Gemini-API-Dokumentation von Google wurden die Imagen-Modelle eingestellt und sind nicht mehr über die API verfügbar. Bei der Migration einer an Imagen angebundenen Bildgenerierungsintegration müssen daher drei Punkte gemeinsam berücksichtigt werden: Modellname, Aufrufmethode und Verarbeitung der zurückgegebenen Antwort. Diese Anleitung erläutert, wie Sie diese Änderungen in Ihrer bestehenden Integration überprüfen können.

Die Anleitung ist als Migrations-Checkliste für Anwendungen und Workflows gedacht, die die API nutzen. Die Quelldokumentation enthält keine Installationsbefehle für eine bestimmte Programmiersprache, Paketversionen oder ein vollständiges Codebeispiel. Daher finden Sie hier weder Beispielcode noch nicht in der Quelle aufgeführte Schritte zur Benutzeroberfläche.

Voraussetzungen und Vorbereitung der Migration

Die Migration betrifft Imagen-Anbindungen, die über die Gemini API Bilder generieren. In der Quelle werden keine Anforderungen an Kontotyp, Gebühren, Kontingente oder Hardware genannt. Ein sinnvoller erster Schritt besteht darin, die vorhandenen API-Aufrufe im Projekt sowie die Bereiche zu ermitteln, die Bildantworten verarbeiten.

Listen Sie die Stellen in der Codebasis, den Konfigurationsdateien oder den Anfragevorlagen auf, an denen Imagen-Modellnamen verwendet werden. Notieren Sie anschließend, mit welcher Methode der Bildgenerierungsaufruf erfolgt und welchen Teil der API-Antwort die Anwendung verarbeitet. Diese Prüfung zeigt, dass möglicherweise nicht nur das Senden der Anfrage angepasst werden muss, sondern auch die Verarbeitung der Antwort.

Schritt für Schritt zu Nano Banana wechseln

1. Aktuellen Modellnamen ermitteln. Suchen Sie die Aufrufstellen, an denen Imagen verwendet wird, und prüfen Sie, mit welchem Modellnamen die Anwendung die API aufruft. Google empfiehlt, statt der Imagen-Modellnamen gemini-2.5-flash-image zu verwenden oder zu Nano Banana 2-Modellen wie gemini-3.1-flash-image zu wechseln. Aktualisieren Sie die Stelle, an der die Integration das Modell auswählt, und prüfen Sie auch, ob mehrere Aufrufe dieselbe Einstellung verwenden.

2. Aufrufmethode ändern. In Googles Migrationshinweisen wird angegeben, dass anstelle der für Imagen verwendeten Methode client.models.generate_images die Methode client.models.generate_content verwendet werden soll. Behandeln Sie diese Änderung getrennt von der Aktualisierung des Modellnamens. Ist zwar der neue Modellname eingestellt, ruft die Anwendung aber weiterhin die alte Methode auf, ist die Migration nicht abgeschlossen.

3. Verarbeitung der Antwort überprüfen. Nano Banana gibt die Antwort als Inhaltsteile mit Bilddaten zurück – nicht in Form eines speziellen Bildantwortobjekts, wie es bei der bisherigen Verwendung erwartet werden könnte. Prüfen Sie, welche Struktur Ihre Anwendung an der Stelle ausliest, an der sie die API-Antwort erhält. Verfolgen Sie außerdem, wie die Bilddaten an die nachfolgenden Verarbeitungsschritte der Anwendung übergeben werden.

4. Den Ablauf in der eigenen Anwendung testen. Prüfen Sie nach der Änderung von Modellname und Aufrufmethode den gesamten Ablauf mit einer Bildgenerierungsanfrage. Testen Sie nicht nur, ob die Anfrage gesendet wird, sondern auch, ob die Bilddaten aus der Antwort den erwarteten nächsten Schritt in der Anwendung erreichen. Da Googles Migrationshinweise weder einen konkreten Testszenario noch ein erwartetes Ausgabe-Beispiel enthalten, sollte der Umfang der Prüfung an die jeweilige Anwendung angepasst werden.

5. Veraltete Verwendungen und Dokumentation bereinigen. Im Code oder in internen technischen Notizen können noch Imagen-Modellnamen und Hinweise zum alten Antwortformat stehen. Aktualisieren Sie diese, um bei späteren Wartungsarbeiten das Risiko zu verringern, eine Integration mit einem eingestellten Modell oder einer nicht mehr verwendeten Methode einzurichten. Dieser Schritt ist keine neue API-Funktion, sondern eine Wartungsempfehlung, die den Migrationsprozess nachvollziehbar halten soll.

Häufige Fehler

Nur den Modellnamen ändern: Laut Googles Migrationshinweisen müssen neben dem Modellnamen auch die Methode und die Verarbeitung der Antwort berücksichtigt werden. Alle drei Punkte zu prüfen ist wichtig, damit sich die Integration im Hinblick auf die neue Verwendung bewerten lässt.

Das alte Antwortformat erwarten: Da Nano Banana Bilddaten als Inhaltsteile zurückgibt, findet ein Anwendungsteil, der auf ein früheres Bildantwortobjekt ausgelegt ist, die Daten möglicherweise nicht im erwarteten Format. Nehmen Sie die Komponente, die die Antwort verarbeitet, in den Migrationsplan auf.

Nicht dokumentierte Anforderungen voraussetzen: Die Migrationshinweise nennen keine bestimmte Sprache, Paketversion, Gebühren, Kontingente oder Kontobedingungen. Stellen Sie solche Details nicht als verbindliche Anforderungen dar, sondern prüfen Sie sie vor der Implementierung in der jeweils aktuellen Gemini-API-Dokumentation.

Den Test auf das Senden der Anfrage beschränken: Dass eine Anfrage erfolgreich gesendet wurde, belegt für sich allein nicht, dass die Bilddaten aus der Antwort in den nachfolgenden Schritten der Anwendung korrekt verarbeitet werden. Nehmen Sie auch die Antwortverarbeitung in den Testumfang auf.

Auswirkungen auf Workflows in Architektur, Innenarchitektur und Archviz

Für Teams, die die Bildgenerierung über die Gemini API in Konzeptstudien, Innenraumvarianten oder anderen Bildgenerierungsschritten einsetzen, bedeutet diese Änderung, dass die bestehende Integration aktualisiert werden muss. Wird eine Automatisierung mit Imagen betrieben, sollten Modellname, Aufrufmethode und die Komponente, die die Antwort verarbeitet, gemeinsam überprüft werden. In Anwendungen, die erzeugte Bilddaten an einen weiteren Schritt im Projektworkflow übergeben, ist außerdem zu kontrollieren, ob diese Übergabe mit dem neuen Antwortformat kompatibel ist.

Da die Quelle keine Anforderungen an lokale Hardware nennt, lässt sich aus dieser Migration kein bestimmter Workstation- oder GPU-Bedarf ableiten. Auch Angaben zu Preisen und Nutzungsbedingungen fehlen. Büros und Visualisierungsteams sollten vor der Migration die API-Nutzungsbedingungen separat prüfen und ihre bestehende Automatisierung mit den Änderungen an Modell, Methode und Antwort testen.

Nächste Schritte

Erfassen Sie zunächst alle Aufrufe, die von Imagen abhängen. Prüfen Sie dann einen der von Google empfohlenen Modellnamen und die neue Aufrufmethode. Verifizieren Sie abschließend, wie Ihre Anwendung die Antwortteile mit den Bilddaten verarbeitet. Für ausführlichere Beispiele verweist Google auf den Leitfaden zur Bildgenerierung. Einzelheiten zur Implementierung, die in dieser Anleitung nicht behandelt werden, finden Sie in der aktuellen offiziellen Dokumentation.

Quelle und Lizenz

Diese Anleitung wurde auf Grundlage des offiziellen englischsprachigen Google-Leitfadens zur Verwendung von Imagen in der Gemini API und zum Wechsel zu Nano Banana erstellt. Sofern nicht anders angegeben, steht die Quelle unter der Lizenz CC BY 4.0. Der Text wurde ins Türkische übertragen; Codebeispiele, die nicht in der Quelle enthalten sind, wurden nicht ergänzt.