Nano Banana 2 API
Générez des images à partir de texte avec Nano Banana 2 via l'API indépendante de GoEnhance. Choisissez un ratio pris en charge et une taille de sortie de 0.5K–4K, puis récupérez le résultat par polling ou par callback. GoEnhance n'est pas Google, et cet endpoint n'est pas l'API Gemini officielle de Google.
Créer une clé API
Génération texte-image flexible
Contrôle du prompt et de la sortie
Envoyez model avec la valeur nano-banana-2 et un prompt de 1–2000 caractères. Choisissez un ratio documenté, une taille de sortie et, si vous le souhaitez, la profondeur de raisonnement.
Livraison asynchrone de la tâche
Une soumission réussie renvoie img_uuid. Interrogez GET /api/v1/jobs/detail par polling ou fournissez une URL de callback HTTPS accessible publiquement pour recevoir les mises à jour de statut.
Vérifiez l'identifiant exact du modèle et les champs documentés avant de soumettre une tâche de génération.
Paramètres de l'API Nano Banana 2
Modèle
Obligatoire. Définissez <code>model</code> exactement sur <code>nano-banana-2</code>.
Prompt
Description textuelle obligatoire, de 1 à 2000 caractères.
Ratio d'image
Paramètre facultatif <code>ratio</code>. Les valeurs prises en charge sont auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 4:5, 5:4, 21:9, 1:4, 4:1, 1:8 et 8:1.
Taille d'image
Le paramètre facultatif <code>image_size</code> vaut <code>1k</code> par défaut ; les valeurs disponibles sont <code>0.5k</code>, <code>1k</code>, <code>2k</code> et <code>4k</code>.
Contrôles de génération
Les contrôles facultatifs incluent <code>web_search</code> ainsi que les valeurs de <code>thinking_level</code>, sensibles à la casse : <code>High</code> ou <code>Minimal</code>.
Autorisation et callback
Envoyez l'en-tête <code>Authorization</code>. La <code>custom_callback_url</code> facultative doit être une URL HTTPS accessible publiquement.
La facturation se fait par image générée et varie selon la taille de sortie demandée.
Tarifs de l'API Nano Banana 2 et fonctionnement des tâches
Tarifs 0.5K et 1K
0.5K coûte 3 tokens ($0.060) par image. 1K coûte 3,3 tokens ($0.066) par image.
Tarifs 2K et 4K
2K coûte 5 tokens ($0.100) par image. 4K coûte 7,5 tokens ($0.150) par image.
Résultat asynchrone
La soumission renvoie <code>img_uuid</code>, et non l'image finale. Interrogez l'endpoint de détail de la tâche ou traitez les événements de callback pour obtenir le résultat final.
Intégrer Nano Banana 2 en trois étapes
1
1. Soumettre une requête de génération
Envoyez un POST JSON à
https://api.goenhance.ai/api/v1/images/generations avec l'autorisation, model, prompt et les champs facultatifs de ratio, de taille, de recherche web, de raisonnement ou de callback. 2
2. Conserver l'img_uuid
Lisez
data.img_uuid dans la réponse réussie et associez-le à la requête de votre application. 3
3. Interroger ou recevoir les callbacks
Interrogez
GET /api/v1/jobs/detail par polling ou traitez les événements de callback. GoEnhance documente jusqu'à trois nouvelles tentatives de callback lorsque votre endpoint ne renvoie pas de HTTP 200, avec un délai d'attente de trois secondes par tentative.Construisez des workflows de génération d'images maîtrisés pendant que votre application gère les prompts, la relecture, le stockage et la diffusion.
Cas d'usage de l'API Nano Banana 2
Illustration éditoriale
Transformez des briefs d'articles structurés en visuels candidats pour une file de relecture humaine.
Storytelling produit
Générez des concepts de scène à partir des descriptions produit, en vue d'une validation ultérieure par les équipes marque et conformité.
Déclinaisons de campagne
Créez des variantes de prompt et de ratio tout en suivant chaque tâche asynchrone séparément.
Workflows de localisation
Produisez des concepts visuels adaptés à chaque région à partir de prompts localisés, sans modifier votre architecture de traitement des tâches.
Développement de concepts
Explorez personnages, accessoires, environnements et directions artistiques avant de figer les assets de production.
Pipelines créatifs automatisés
Reliez les callbacks à des services de modération, de validation, de stockage ou de traitement d'assets en aval.
Réponses concrètes sur les tarifs, les paramètres, la livraison asynchrone et le rapport avec l'API Google.