Migration de Nano Banana 2 vers 2.1 : ce qu'il faut changer dans l'API

Nano Banana 2.1 continue d'utiliser l'interface de tâches asynchrones de HiAPI, la migration du code reste donc limitée, mais plusieurs contraintes d'entrée doivent être revérifiées. Le changement le plus visible concerne la valeur de model ; le nombre d'images de référence et la taille de fichier par image ont également changé. Les prix doivent être vérifiés sur la page en temps réel et dans les enregistrements de tâches avant la publication.

Cet article s'appuie sur le contrat d'interface actuellement affiché par la page du modèle Nano Banana 2 et la page du modèle Nano Banana 2.1. Les exemples reprennent la structure de requête de la documentation actuelle ; avant de basculer le trafic de production, validez-les sur un compte de test disposant d'un solde.

La modification minimale consiste à remplacer model

Les deux versions passent par la création de tâches asynchrones :

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": {
      "prompt": "A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png"
    }
  }'

Si la requête d'origine était de la génération d'image à partir de texte, la migration consiste principalement à modifier model :

- "model": "nano-banana-2"
+ "model": "gemini-nano-banana-2.1"

L'interface documentée reste POST /v1/tasks. Une fois la requête acceptée, l'interface de création renvoie un ID de tâche, utilisé pour le polling ou le traitement par callback. Le flux de polling ou de callback existant peut être conservé, mais il faut tout de même vérifier les champs d'état de tâche et de résultat actuels.

Champs conservés et limites à revérifier impérativement

Le contrat actuel de la 2.1 conserve les champs d'entrée courants de la version 2 : prompt, image_input (facultatif), aspect_ratio, resolution et output_format. Le test de fumée ci-dessous, réalisé avec un solde, a accepté les deux formes, génération à partir de texte et référence d'image ; lors du basculement définitif, vérifiez tout de même le contrat en temps réel, car il évolue selon les versions.

La limite d'images de référence a changé. La page de Nano Banana 2 indique un maximum de 14 images et 10 Mo par image ; la page de la 2.1 indique un maximum de 10 images et 30 Mo par image. Remplacer uniquement l'ID de modèle en continuant à transmettre les 14 images de l'ancienne version fera dépasser la nouvelle limite. Le client doit vérifier le nombre selon la nouvelle limite et décider de tronquer ou d'avertir directement l'utilisateur.

La page du modèle 2.1 n'expose pas d'entrée mask. Lors de la migration, n'ajoutez pas de champ mask de votre propre initiative, sauf si la documentation d'interface ultérieure le prévoit explicitement. Pour l'édition d'image, transmettez l'image d'origine via image_input, puis précisez dans prompt ce qu'il faut modifier et les détails à conserver.

{
  "model": "gemini-nano-banana-2.1",
  "input": {
    "prompt": "Keep the amber glass serum bottle and black dropper cap from the reference image. Place it on a sunlit wooden bathroom counter beside a folded cream linen towel and eucalyptus, preserving the bottle shape and blank label.",
    "image_input": ["https://static.hiapi.ai/blog/gemini-nano-banana-2-1-ecommerce-product-images/studio.jpg"],
    "resolution": "1K",
    "aspect_ratio": "16:9",
    "output_format": "png"
  }
}

Cette requête a été menée à bien lors du test de fumée avec solde ; le résultat est visible ici. La page de la 2.1 indique actuellement que les images de référence acceptées sont JPEG, PNG et WebP, avec une taille maximale de 30 Mo par image.

Vérifier les prix à deux niveaux

Au moment de la vérification des pages modèle le 2026-10-16, les paliers 1K, 2K et 4K de Nano Banana 2.1 affichaient respectivement 44, 72 et 116 crédits. Avant toute planification budgétaire, consultez la page des prix en temps réel et la page du modèle ; la relecture de la facturation reste à vérifier indépendamment.

Ne figez pas comme prix permanent un tarif promotionnel ou un chiffre affiché sur la page d'un compte donné. Lors de la validation de mise en production, consignez la résolution, le montant affiché avant soumission et la facturation réelle après achèvement de la tâche.

Basculer les deux model ID avec le même prompt

Pour vérifier le parcours de migration, nous avons soumis le même prompt 1K, 1:1 avec chacun des deux model ID publics. Les deux requêtes ont créé une tâche et atteint l'état success. Les détails du flacon et du comptoir diffèrent entre les deux images ; ce jeu de résultats convient donc à vérifier le routage et le traitement des résultats, mais ne suffit pas à classer la qualité d'image ni à prouver que l'identité du produit est identique.

Prompt utilisé pour les deux requêtes :

A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering

Route	Model ID	Résultat
Nano Banana 2	nano-banana-2	1K, 1:1, PNG, tâche menée à bien
Nano Banana 2.1	gemini-nano-banana-2.1	1K, 1:1, PNG, tâche menée à bien

Cette validation de migration montre que le model ID de la 2.1 accepte la structure de tâche de génération texte-image de la documentation actuelle et renvoie l'image via le même flux asynchrone. Les différences visuelles d'un seul échantillon ne doivent être prises que comme observation, et non comme résultat de comparaison des modèles.

Liste de contrôle avant mise en production

1. Remplacer nano-banana-2 par l'ID exact de la nouvelle version : gemini-nano-banana-2.1.
2. Conserver le flux asynchrone POST /v1/tasks et le traitement existant des états de tâche.
3. Valider que image_input est un tableau d'URL publiques d'images, avec un maximum de 10 images.
4. Remplacer l'hypothèse de 10 Mo par image de l'ancienne version par la limite de 30 Mo actuellement indiquée sur la page de la 2.1.
5. Conserver prompt, aspect_ratio, resolution et output_format, et retirer les champs sans fondement documentaire, comme mask.
6. Envoyer sur le compte de test une tâche en texte seul et une tâche d'édition avec image de référence, et enregistrer la requête, l'ID de tâche, l'état final, l'URL du résultat et le montant facturé.
7. Comparer une fois avec les résultats et la gestion d'erreurs de l'ancienne version, puis basculer le modèle par défaut pour tous les utilisateurs.

Relecture de la facturation et maintenance ultérieure

Le test de fumée ci-dessus a validé la structure des requêtes texte-image et image-image, la création de tâche, l'état final réussi et l'URL du résultat. La facturation n'a pas été relue indépendamment à partir des tâches terminées ; le coût de production doit donc toujours se baser sur la page des prix en temps réel et les enregistrements de tâches. Si le contrat ou les limites de la page modèle changent avant la publication, revérifiez également.

Questions fréquentes

Faut-il changer d'interface pour migrer vers Nano Banana 2.1 ?

Actuellement, les deux pages modèle utilisent POST /v1/tasks. Modifiez d'abord l'ID de modèle, puis validez les structures d'entrée et de retour avec de vraies requêtes.

Peut-on encore utiliser nano-banana-2 ?

Cet ID désigne toujours Nano Banana 2. Pour appeler la 2.1, utilisez gemini-nano-banana-2.1.

Peut-on encore transmettre 14 images de référence après la migration ?

La limite actuellement indiquée sur la page du modèle 2.1 est de 10 images. En cas de dépassement, le client doit réduire le nombre d'images ou rejeter la requête.

Faut-il une autre interface pour l'édition avec image de référence ?

La page actuelle ne propose pas d'interface d'édition distincte. Continuez d'utiliser le même model ID, ajoutez image_input et précisez dans le prompt ce qu'il faut modifier et quels détails conserver.

La 2.1 est-elle moins chère pour tous les comptes ?

La page publique affiche actuellement des nombres de crédits standard plus bas pour chaque résolution, mais les prix peuvent évoluer et la page peut dépendre de l'état du compte ou d'une campagne. Avant de conclure sur le coût, vérifiez à la fois les prix en temps réel et les enregistrements de facturation après achèvement des tâches.

Pour aller plus loin

• Tutoriel d'intégration de l'API Nano Banana 2.1
• Prix de l'API Nano Banana 2.1
• Comment utiliser l'API Nano Banana 2

Essayez Nano Banana 2.1 sur la page modèle de HiAPI.