Changer le nom du modèle Imagen ne suffit pas. La configuration de la requête et la lecture des images doivent correspondre à l’API et au SDK de remplacement.
Identifier le point d’accès réellement utilisé
Le calendrier Gemini API indique le 17 août 2026 pour les modèles Imagen 4 standard, Fast et Ultra. Le guide de migration Firebase confirme aussi leur arrêt et oriente vers Gemini 3.1 Flash Image ou Gemini 3 Pro Image selon le modèle précédent. Relevez identifiant complet, backend et version du SDK avant modification.
Firebase et API directe ont des exemples distincts
Dans Firebase AI Logic, ImagenModel/generateImages devient GenerativeModel/generateContent, avec sortie image configurée et lecture des données dans les parties retournées. Le guide indique des anciennes options non prises en charge, dont numberOfImages et imageFormat. Ces instructions concernent cette intégration ; elles ne garantissent pas un format identique dans toutes les interfaces Gemini.
Le guide actuel de génération Gemini directe présente des appels Interactions. Sa propriété output_image récupère la dernière image ; les sorties mêlant textes et images nécessitent de parcourir les étapes. Il montre aussi une configuration MIME. Transposer un parseur sans adaptation peut donc perdre des images ou prendre du texte pour un fichier.
Rendre les échecs visibles
Isolez le code propre au fournisseur derrière un adaptateur retournant les champs utiles au produit : données de l’image, type MIME, statut et diagnostic. Définissez le traitement d’une réponse HTTP réussie sans image exploitable. N’affichez pas un lien de téléchargement vide et ne relancez pas indéfiniment.
Un petit jeu de migration peut couvrir quatre cas : une image valide, du texte sans image, une génération bloquée ou échouée, et plusieurs blocs alternant texte et image. L’adaptateur doit fournir les images attendues ou une erreur explicite. Il s’agit de tests de contrat proposés, pas de résultats d’appels payants que nous aurions effectués.
Si le produit demande quatre variantes, suivez quatre sorties acceptées dans le travail en cours. Répéter les appels peut réaliser ce comportement lorsque l’interface le permet, mais les requêtes parallèles partagent des quotas et peuvent chacune coûter ou échouer. Conservez les succès partiels au lieu de recommencer tout le lot.
Comparez enfin un même brief visuel avant de modifier les valeurs par défaut : cadrage, texte requis, cohérence du sujet et comportement des retouches. La compatibilité d’API établit que l’application sait lire la réponse. Elle ne garantit pas des images, une latence ou un coût équivalents.
Revue du 8 septembre : sources primaires vérifiées, explications et illustration originales ajoutées ; événements ultérieurs explicitement datés.