Premiers pas avec l'API Nano Banana Pro

L'API Nano Banana Pro est une interface pratique et prête pour la production permettant de générer des images avec les derniers modèles basés sur Gemini. Ce guide de l'API Nano Banana Pro se concentre sur l'utilisation réelle : comment rédiger des prompts, structurer les requêtes, interpréter les réponses et construire un flux de travail sur lequel votre produit peut s'appuyer.

Si vous souhaitez la présentation officielle, les démos et le contexte produit de Nano Banana 2, commencez par le hub Nano Banana 2.

Qu'est-ce que l'API Nano Banana Pro ?

L'API Nano Banana Pro vous offre une interface REST simple pour la génération d'images de haute qualité. Vous envoyez un prompt et des références optionnelles, et vous recevez des images que vous pouvez stocker et livrer dans votre application. Elle est conçue pour les équipes qui ont besoin de résultats cohérents, de flux de travail répétables et de modèles d'intégration prévisibles.

Quand utiliser l'API Nano Banana Pro

Utilisez l'API Nano Banana Pro lorsque vous souhaitez des visuels rapides et à la demande sans construire un pipeline de modèles interne :

• Contenu marketing pour les publicités et les pages de destination
• Imagerie produit pour les catalogues et les listes e-commerce
• Brouillons créatifs pour les premiers concepts et les mood boards

Capacités principales

L'API est construite autour de quelques points forts essentiels qui comptent en production :

• Génération texte-image pour transformer le langage naturel en visuels
• Création image-image pour remixer ou construire sur des prises de vue existantes
• Sorties tenant compte des références pour garder le style et le sujet cohérents
• Performance évolutive pour alimenter les tâches par lots et les flux de travail automatisés

Démarrage rapide de l'API Nano Banana Pro

1. Obtenir l'accès

Créez un compte dans le tableau de bord EvoLink, puis générez une clé API pour votre projet. Conservez la clé dans un stockage de secrets sécurisé et ne l'exposez jamais dans le code côté client.

2. Faites votre première requête

Voici un exemple cURL minimal. Remplacez les espaces réservés par vos valeurs réelles.

curl -X POST "API_BASE/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "prompt": "A beautiful sunset over mountains, digital art style",
    "size": "ASPECT_RATIO",
    "quality": "RESOLUTION_TIER"
  }'

3. Gérer la réponse

La réponse inclut généralement des métadonnées et une liste d'URL ou d'ID d'images. Persistez les résultats rapidement et stockez-les dans votre propre couche de stockage pour un accès à long terme.

{
  "created": 1737014400,
  "data": [
    {
      "url": "IMAGE_URL"
    }
  ]
}

Paramètres principaux à connaître

Voici les paramètres que vous utiliserez le plus souvent lors de l'appel à l'API Nano Banana Pro :

• model : Utilisez le modèle activé pour votre compte. Choisissez un niveau économique pour les brouillons et un niveau premium pour les actifs finaux.
• prompt : Votre texte d'instruction. Soyez explicite sur le sujet, le style et l'ambiance.
• size : Le rapport d'aspect ou le préréglage de taille qui correspond à votre emplacement (carré, portrait ou paysage).
• quality : Le niveau de résolution dont vous avez besoin pour la sortie finale.
• image_urls : Images de référence optionnelles si vous souhaitez conserver la cohérence du sujet ou du style.

Tâches asynchrones et URL d'images

De nombreuses équipes exécutent l'API de manière asynchrone : soumettre une tâche, interroger la tâche jusqu'à ce qu'elle soit terminée, puis télécharger et stocker l'image. Les URL peuvent être limitées dans le temps, traitez-les donc comme éphémères et déplacez-les dans votre propre stockage dès qu'elles sont prêtes.

Guide des Prompts

Le moyen le plus rapide d'améliorer les résultats est d'utiliser une structure de prompt claire. Une formule simple fonctionne bien :

Sujet + Contexte + Style + Éclairage + Composition + Qualité

Voici d'autres conseils pratiques pour les prompts :

1. Soyez spécifique - Nommez le sujet et décrivez les détails clés.
2. Définissez le style - Photoréaliste, aquarelle, cinématographique, éditorial.
3. Contrôlez la composition - Gros plan, plan large, vue de dessus ou centré.

Exemples de Prompts

Contrôle qualité et itération

Traitez la génération comme une boucle de conception rapide. Commencez par un prompt large, puis itérez :

• Ajoutez ou supprimez des détails en fonction de la première sortie.
• Verrouillez un style avant d'affiner un sujet.
• Enregistrez les meilleurs prompts pour que votre équipe puisse les réutiliser plus tard.
• Utilisez des images de référence lorsque la cohérence est importante dans une série.

Liste de contrôle de production

Utilisez cette liste de contrôle avant de déployer l'API Nano Banana Pro dans votre flux de travail :

• Clé API stockée dans un stockage de secrets sécurisé côté serveur
• Prompts de base documentés pour vos principaux cas d'utilisation
• Images de sortie enregistrées dans un stockage permanent

Résumé

L'API Nano Banana Pro est un moyen fiable de générer des visuels de haute qualité avec une interface REST propre. Commencez par des prompts clairs, itérez rapidement et documentez vos meilleurs résultats. Pour les équipes qui livrent rapidement, cela maintient le flux créatif en mouvement sans outils lourds.