Guide de tarification et d'estimation des coûts de l'API Nano Banana Pro

Un modèle d'image qui semble bon marché peut tout de même générer une facture surprenante si vous interprétez mal son unité de facturation. La tarification de l'API Nano Banana Pro sur TokenLab en est un bon exemple. nano-banana-pro affiche un prix par image, tandis que ses voisins nommés Gemini, gemini-3-pro-image et gemini-3.1-flash-image, affichent des prix par token. Ce guide présente ces entrées côte à côte, détaille une estimation par lot et montre les deux formats de requête que vous enverrez réellement. Il explique également comment confirmer le coût final. Chaque chiffre provient de l'API de modèle en direct et de la documentation de TokenLab, observés le 03/10/2026.

Points clés à retenir

• nano-banana-pro affiche un prix de base de 0,067 USD par image, avec une fourchette listée de 0,067 à 0,12 selon les entrées tarifaires (API de modèle en direct, observée le 03/10/2026).
• nano-banana-2 affiche 0,0335 par image et nano-banana-2-lite affiche 0,0168 ; le prix de base de Pro est donc environ le double du premier et quatre fois celui du second.
• gemini-3-pro-image et gemini-3.1-flash-image sont facturés au token ; une formule de budget par image ne s'applique donc pas à eux.
• Les requêtes d'image de référence Nano Banana sont envoyées à /v1/images/generations avec operation: "image-to-image", et non à /v1/images/edits.
• La charge finale se trouve dans Usage et dans billing_transaction_id, et non dans votre estimation.
• Ce guide ne contient aucune donnée de benchmark ; il ne prétend donc pas que la sortie Pro est meilleure que celle des IDs moins chers.

Aperçu de la tarification de l'API Nano Banana Pro

Nous avons lu les entrées du catalogue pour cinq modèles d'image et les avons rassemblées dans un tableau. Le bloc de prix pour nano-banana-pro indique « possède des entrées tarifaires supplémentaires », et nous n'avons pas trouvé de ventilation détaillée par résolution dans les preuves. Le tableau montre donc ce qui est listé, sans plus.

ID de modèle	Unité de tarification	Entrées tarifaires listées (USD)	Source	Observé
nano-banana-pro	per_image	Base per_request 0,067 ; résumé de la fourchette 0,067 à 0,12 ; entrée de sortie texte native-gemini-text-output-20260723 (per_token) : entrée 1, sortie 6	API de modèle en direct	03/10/2026 (tarification mise à jour le 02/10/2026T16:53:30.068Z)
nano-banana-2	per_image	Base per_request 0,0335 ; fourchette 0,0225 à 0,0755 ; entrée de sortie texte (per_token) : entrée 0,25, sortie 1,5	API de modèle en direct	03/10/2026
nano-banana-2-lite	per_image	Base per_request 0,0168 ; valeur de fourchette unique 0,0168 ; entrée google-1k (1k, text-to-image et image-to-image) : 0,0168	API de modèle en direct	03/10/2026
gemini-3-pro-image	per_token	Entrée 1 et sortie 6 par 1M pour la sortie texte ; entrée de sortie image : 60	API de modèle en direct	03/10/2026
gemini-3.1-flash-image	per_token	Entrée 0,25 et sortie 1,5 par 1M pour la sortie texte ; entrée de sortie image : 30	API de modèle en direct	03/10/2026

Deux détails dans le tableau sont faciles à manquer.

• Le catalogue indique que la sortie image de nano-banana-pro « conserve les niveaux de résolution par image existants ». Il ne précise pas quel niveau correspond à 0,067 et lequel correspond à 0,12. Lisez GET /v1/models/nano-banana-pro/pricing pour obtenir cette correspondance avant de valider un budget, comme le conseille le guide de facturation.
• L'entrée de sortie texte sur nano-banana-pro est facturée au token. Traitez-la comme un poste distinct de la charge par image, et vérifiez si vos requêtes produisent parfois une sortie texte.

La documentation de facturation met également en garde contre le codage en dur des tableaux de prix copiés. Notre tableau est un instantané daté, et votre code devrait lire le prix au moment où il en a besoin.

Élaboration d'une estimation par lot

Imaginez une équipe qui génère 200 images de produits en une seule exécution. Nous avons multiplié les prix listés pour voir l'écart. Ce sont des estimations, pas des devis.

Modèle	Calcul	Estimation (USD)
nano-banana-pro, prix de base	200 × 0,067	13,40
nano-banana-pro, haut de la fourchette listée	200 × 0,12	24,00
nano-banana-2, prix de base	200 × 0,0335	6,70
nano-banana-2, haut de la fourchette listée	200 × 0,0755	15,10
nano-banana-2-lite	200 × 0,0168	3,36

Ajoutons maintenant la régénération. Si l'équipe rejette 20 % des résultats et les refait sur nano-banana-pro au prix de base, cela représente 40 images supplémentaires. Le total devient 240 × 0,067 = 16,08, là encore une estimation. La documentation asynchrone indique qu'une tâche échouée n'est pas facturée, mais qu'une nouvelle tentative de génération échouée crée une nouvelle tâche et peut entraîner une nouvelle charge. Les tentatives réussies sont facturées comme toute autre image terminée.

L'écart entre 13,40 et 24,00 représente l'incertitude réelle. Il provient des entrées tarifaires que nous ne pouvons pas faire correspondre aux résolutions à partir des seules preuves. Exécutez un petit lot de test à votre résolution cible, puis comparez l'enregistrement Usage avec le calcul ci-dessus.

Quand choisir nano-banana-pro plutôt que les IDs moins chers

Les différences documentées sont plus minces que vous pourriez l'espérer. Voici ce que les docs et le catalogue confirment.

• Sélecteurs. nano-banana-pro et nano-banana-2 prennent tous deux en charge aspect_ratio et resolution (1k, 2k, 4k) pour le text-to-image et l'image-to-image. Pour nano-banana-2-lite, la seule entrée tarifaire trouvée est à 1k, et ses formats de requête acceptés sont « non listés » dans le catalogue. Si vous avez besoin d'une sortie 2k ou 4k, nous n'avons trouvé aucun support documenté pour Lite.
• Livraison. nano-banana-pro liste la livraison TokenLab Verified et Official comme disponibles pour les deux opérations. gemini-3-pro-image ne liste que Verified.
• Prix. Le prix de base de Pro est de 0,067, contre 0,0335 et 0,0168. Le catalogue ne donne aucune autre raison pour cet écart.
• Cycle de vie. Tous les trois montrent un stade de cycle de vie actif sans modèle de remplacement et sans date de dépréciation. L'article source qualifiait nano-banana et nano-banana-edit de dépréciés, mais nous n'avons trouvé aucune preuve de cela, nous avons donc abandonné cette affirmation. Vérifiez la page du modèle avant de vous fier à l'un ou l'autre ID.

Ce que nous n'avons pas évalué compte plus que la liste ci-dessus. Nous n'avons aucune donnée sur la qualité d'image, le respect des prompts, le rendu de texte ou la latence pour aucun de ces modèles. Nous ne pouvons donc pas dire que Pro est meilleur que nano-banana-2. Une approche judicieuse consiste à rendre les 20 mêmes prompts sur chaque candidat et à comparer les sorties à l'œil nu. Comparez ensuite le coût par image acceptée dans Usage. C'est la méthode suggérée par la documentation de facturation : le prix listé le plus bas n'est pas toujours le coût le plus bas par tâche terminée.

Une requête de génération et une requête d'édition

Les deux appels ci-dessous utilisent POST /v1/images/generations. Le guide de génération d'image indique que la génération de référence de style Nano Banana ne doit pas être envoyée à /v1/images/edits. Envoyez toujours model explicitement, car les API d'image n'ont pas de valeur par défaut.

Text-to-image, en utilisant les champs listés dans la référence Create Image pour les familles d'images Google :

curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A cinematic portrait of a white cat sitting on a rainy windowsill",
    "aspect_ratio": "16:9",
    "resolution": "2k"
  }'

Édition, signifiant génération d'image de référence avec operation: "image-to-image" et image_urls :

curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "operation": "image-to-image",
    "prompt": "Keep the product shape, change the background to a bright studio setup",
    "image_urls": ["https://example.com/input/product.png"],
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }'

Quelques règles issues de la documentation, observées le 03/10/2026 :

• Les URLs de référence doivent être des http ou https publics. Évitez les URLs de réseau privé, les identifiants intégrés, les fragments et les URLs signées qui pourraient expirer avant le début du traitement.
• Pour une image source privée ou protégée par en-tête, envoyez un fichier image multipart au lieu de image_urls.
• images[] et file_id ne sont pas acceptés sur ce point de terminaison.
• Réglez le délai d'attente de votre client HTTP sur au moins 120 secondes. Si la réponse contient status: "pending", task_id ou poll_url, suivez poll_url au lieu d'attendre.
• Interrogez avec GET /v1/tasks/{id}. Le guide des tâches asynchrones suggère de vérifier toutes les 5 à 10 secondes, et de s'arrêter à completed ou failed.

Enregistrez l'URL renvoyée, l'ID de tâche, le modèle et votre propre ID de travail. Les URLs de résultat éligibles peuvent être conservées comme copies média pendant 30 jours, et media_retention.items affiche le statut de chaque élément et expires_at.

Confirmation de la charge finale

Une estimation n'est qu'un plan. La documentation de facturation décrit où le chiffre réel apparaît.

1. Réserver et libérer. Certaines tâches asynchrones réservent le coût estimé lors de la création. Une tâche terminée est facturée une fois. Une tâche échouée libère ou rembourse le montant en attente.
2. Lire l'ID de transaction. Les réponses non-streaming incluent billing_transaction_id lorsque la facturation se termine avant l'envoi de la réponse. La même valeur peut apparaître dans l'en-tête X-Billing-Transaction-ID. Les tâches asynchrones l'incluent après l'achèvement.
3. Ouvrir Usage. La page Usage affiche l'historique par modèle et une ventilation des coûts. Comparez-la avec votre estimation.
4. Gardez les IDs ensemble. Stockez request_id, task_id, billing_transaction_id et votre propre ID de travail dans un seul enregistrement.
5. Escalader avec des preuves. Si Usage n'affiche aucune charge finale ou montant libéré après la fin de la tâche, envoyez un e-mail à support@tokenlab.sh avec l'ID de requête et l'ID de tâche.

L'option de livraison affecte également le prix. Verified utilise les prix publics de TokenLab, Official utilise une couche de prix basée sur le prix public du fabricant, et Auto essaie d'abord Verified. Vous payez pour l'option qui termine la requête, notez donc celle qui a servi votre lot de test.

FAQ

Est-ce que nano-banana-pro facture par image ou par token ?

L'entrée de base est par image : per_request 0,067 avec l'unité per_image. Le catalogue liste également une entrée de sortie texte facturée par token, à 1 en entrée et 6 en sortie. Vérifiez le point de terminaison de tarification pour voir quelle entrée déclenchent vos types de requêtes.

Puis-je envoyer des éditions nano-banana-pro à /v1/images/edits ?

Non. La documentation indique que les requêtes d'image de référence Nano Banana, y compris nano-banana-pro, appartiennent à /v1/images/generations avec operation: "image-to-image" et image_urls. Le point de terminaison des éditions est documenté pour des modèles tels que gpt-image-2.

Une tâche d'image échouée est-elle facturée ?

Le guide de facturation indique qu'une tâche échouée n'est pas facturée, et que tout montant réservé est libéré ou remboursé. Une nouvelle tentative crée une nouvelle tâche et peut entraîner une nouvelle charge. Dédupliquez par votre propre ID de travail afin qu'un délai d'attente ne déclenche pas une seconde requête de création.

La résolution que je choisis change-t-elle le prix de nano-banana-pro ?

Le catalogue indique que la sortie image conserve les niveaux de résolution par image, et sa fourchette listée va de 0,067 à 0,12. Les preuves ne font pas correspondre les niveaux à 1k, 2k ou 4k. Lisez GET /v1/models/nano-banana-pro/pricing et confirmez avec une requête de test dans Usage.

Quel champ prouve ce qui m'a été réellement facturé ?

Utilisez billing_transaction_id, ou l'en-tête X-Billing-Transaction-ID, et faites-le correspondre à l'enregistrement dans Usage. Le streaming peut se terminer avant la facturation, donc Usage est le recours lorsque l'en-tête est absent.

Pour comparer ces IDs avec d'autres modèles d'image sur vos propres prompts, commencez par le répertoire des modèles.