Passer d’Imagen à Nano Banana dans l’API Gemini : guide étape par étape

Ce que vous apprendrez dans ce guide

Selon la documentation de l’API Gemini de Google, les modèles Imagen ont été arrêtés et ne sont plus accessibles via l’API. Pour migrer une intégration de génération d’images reposant sur Imagen, trois éléments sont donc à prendre en compte : le nom du modèle, la méthode d’appel et le traitement de la réponse. Ce guide explique comment vérifier ces changements dans votre intégration existante.

Ce guide propose une liste de contrôle pour la migration des applications et des workflows utilisant l’API. La documentation source ne fournit ni commandes d’installation pour un langage de programmation précis, ni version de package, ni exemple de code complet. Aucun exemple de code ni aucune étape d’interface absents de la source ne sont donc ajoutés ici.

Prérequis et préparation avant la migration

Cette migration concerne les intégrations à Imagen qui génèrent des images via l’API Gemini. La source ne précise aucun type de compte, tarif, quota ou prérequis matériel. Avant de commencer, repérer les appels API existants et les parties de l’application qui utilisent la réponse image constitue une première étape suffisante.

Dressez la liste des endroits où les noms de modèles Imagen sont utilisés dans le code, les fichiers de configuration ou les modèles de requête. Notez ensuite la méthode utilisée pour générer des images et la partie de la réponse API consommée par l’application. Cette vérification montre que les changements ne se limitent pas forcément à l’envoi de la requête : le code qui traite la réponse peut également nécessiter des modifications.

Migration vers Nano Banana, étape par étape

1. Identifiez le nom du modèle actuellement utilisé. Repérez les appels qui utilisent Imagen et vérifiez le nom de modèle employé par l’application. Google recommande de remplacer les noms de modèles Imagen par gemini-2.5-flash-image ou de passer à un modèle Nano Banana 2 tel que gemini-3.1-flash-image. Pour choisir l’option à utiliser, mettez à jour l’endroit où l’intégration définit le modèle et vérifiez si plusieurs appels utilisent le même paramètre.

2. Modifiez la méthode d’appel. Dans ses notes de migration, Google indique qu’il faut remplacer la méthode client.models.generate_images, utilisée avec Imagen, par client.models.generate_content. Traitez cette modification comme un contrôle distinct de la mise à jour du nom du modèle. Si l’application continue d’appeler l’ancienne méthode, la migration n’est pas terminée, même si le nouveau nom de modèle est configuré.

3. Examinez le traitement de la réponse. Nano Banana renvoie les données image sous forme de parties de contenu, et non dans un objet de réponse image dédié, comme on pourrait s’y attendre avec l’ancienne méthode. Vérifiez quelle structure l’application lit lorsqu’elle reçoit la réponse de l’API. Suivez également le cheminement des données image dans les étapes suivantes de l’application.

4. Testez le workflow de bout en bout dans votre application. Après avoir modifié le nom du modèle et la méthode d’appel, vérifiez le flux avec une requête de génération d’image. Testez non seulement l’envoi de la requête, mais aussi le fait que les données image de la réponse parviennent bien à l’étape suivante attendue par l’application. Les notes de migration de Google ne proposant ni scénario de test précis ni exemple de sortie attendue, définissez la portée des vérifications en fonction de l’usage de votre application.

5. Mettez à jour les anciennes références et la documentation. Il peut rester dans le code ou les notes techniques de l’équipe des noms de modèles Imagen et des informations sur l’ancien format de réponse. Leur mise à jour réduit le risque de créer ultérieurement une nouvelle intégration à partir d’un modèle arrêté ou d’une méthode obsolète. Cette étape n’est pas une nouvelle fonctionnalité de l’API, mais une recommandation de maintenance pour garder la migration compréhensible.

Erreurs fréquentes

Ne modifier que le nom du modèle : les instructions de migration de Google impliquent de prendre également en compte la méthode d’appel et le format de traitement de la réponse. Il est important de vérifier ces trois points pour évaluer l’intégration au regard du nouvel usage.

S’attendre à l’ancien format de réponse : Nano Banana renvoie les données image dans des parties de contenu. Une partie de l’application conçue pour un ancien objet de réponse image risque donc de ne pas trouver ces données au format attendu. Incluez le composant qui consomme la réponse dans votre plan de migration.

Supposer des prérequis qui ne figurent pas dans la source : les notes de migration ne précisent ni langage ou version de package, ni tarif, quota ou condition de compte. Plutôt que de présenter ces éléments comme des exigences établies, vérifiez-les dans la documentation Gemini API à jour avant le déploiement.

Limiter les tests à l’envoi de la requête : le succès de l’envoi ne suffit pas à prouver que les données image de la réponse sont correctement utilisées par les étapes suivantes de l’application. Incluez aussi le traitement de la réponse dans vos tests.

Conséquences pour l’architecture, le design d’intérieur et les workflows d’archviz

Pour les équipes qui utilisent la génération d’images via l’API Gemini dans des études de concept, des variantes d’aménagement intérieur ou d’autres étapes de création visuelle, ce changement implique de mettre à jour l’intégration existante. Si une automatisation repose sur Imagen, il faut examiner ensemble le nom du modèle, la méthode d’appel et la partie de l’application qui exploite la réponse. Dans les applications qui transmettent les données image générées à une autre étape du projet, il convient aussi de vérifier la compatibilité de ce transfert avec le nouveau format de réponse.

La source ne précise aucun prérequis matériel local : il est donc impossible d’en déduire un besoin particulier en station de travail ou en GPU pour cette migration. Les prix et conditions d’utilisation ne sont pas non plus détaillés. Avant la migration, les bureaux et les équipes de visualisation ont intérêt à examiner séparément les conditions d’utilisation de l’API et à tester les changements de modèle, de méthode et de réponse dans leur automatisation existante.

Étapes suivantes

Commencez par recenser les appels qui dépendent d’Imagen. Évaluez ensuite l’un des noms de modèles recommandés par Google et la nouvelle méthode d’appel, puis vérifiez comment votre application traite les parties de réponse contenant les données image. Pour des exemples plus détaillés, Google renvoie vers son guide de génération d’images. Pour les aspects de mise en œuvre qui ne sont pas abordés ici, consultez la documentation officielle à jour.

Source et licence

Ce guide est adapté du guide officiel en anglais de Google sur l’utilisation d’Imagen dans l’API Gemini et la migration vers Nano Banana. Sauf indication contraire, la source est publiée sous licence CC BY 4.0. Le texte a été adapté en turc ; aucun exemple de code absent de la source n’a été ajouté.