Communitygithub.com

Nanobanana 2 Lite – Génération d'Images

Exemples d'API et compétence d'agent installable pour EvoLink, permettant de générer des images avec Nanobanana 2 Lite.

Qu'est-ce que Nanobanana 2 Lite – Génération d'Images ?

Cette compétence expose l'API de génération d'images Nanobanana 2 Lite via EvoLink, accompagnée d'un script shell et d'un guide interactif pour les agents IA (Claude Code, OpenClaw, OpenCode, Cursor). Elle permet de soumettre des tâches de génération d'images, de suivre leur progression et de récupérer les résultats, tout en gérant les erreurs courantes (clé API invalide, solde insuffisant, limites de débit). L'agent guide l'utilisateur pas à pas : vérification de la clé API, compréhension de l'intention, collecte des paramètres manquants en une seule fois, puis exécution non bloquante du script. Le protocole de sortie structuré (TASK_SUBMITTED, STATUS_UPDATE, RESULT_URL) évite les doubles soumissions et économise les crédits API. Idéale pour intégrer la génération d'images dans des workflows d'agents de développement.

Compatible avec✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add Evolink-AI/nanobanana-2-lite-image-generate-api-skill

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Nanobanana 2 Lite – Génération d'Images ?

Nanobanana 2 Lite – Génération d'Images est exposé ici en tant que point d'API EvoLink avec une compétence d'agent installable correspondante.

Quand activer cette compétence

Activez cette compétence lorsque l'utilisateur demande :

  • Utiliser Nanobanana 2 Lite – Génération d'Images
  • Exécuter Nanobanana 2 Lite – Génération d'Images via EvoLink
  • Générer un résultat de modèle
  • Tester le flux API

Mots-clés : nanobanana-2-lite-image-generation, evolink, api, agent, compétence

Emplacement du script

IMPORTANT : Tous les chemins de script dans ce fichier sont relatifs au répertoire contenant ce fichier SKILL.md. Avant d'exécuter un script, résolvez le chemin absolu :

SKILL_DIR = répertoire contenant ce fichier SKILL.md
Script = {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh

Par exemple, si ce SKILL.md se trouve dans ~/.claude/skills/nanobanana-2-lite-image/SKILL.md, alors le script se trouve dans ~/.claude/skills/nanobanana-2-lite-image/scripts/nanobanana-2-lite-image.sh.

Après l'installation

Lorsque cette compétence est chargée pour la première fois, saluez l'utilisateur de manière proactive et lancez la configuration :

  1. Vérifiez si EVOLINK_API_KEY est défini (exécutez : echo $EVOLINK_API_KEY)

  2. C'est tout. Une seule question. L'utilisateur est maintenant dans le flux.

Ne listez PAS les fonctionnalités, n'affichez PAS de menu et ne déversez PAS d'instructions. Posez simplement une question pour avancer.

Principes fondamentaux

  1. Guider, ne pas décider — Présentez des options et laissez l'utilisateur décider. Ne faites pas d'hypothèses sur ses préférences.
  2. Laissez l'utilisateur conduire — S'il a une idée, utilisez ses mots. S'il a besoin d'inspiration, suggérez et laissez-le choisir ou affiner.
  3. Conscience intelligente du contexte — Reconnaissez ce que l'utilisateur a déjà fourni et ne demandez que les éléments manquants.
  4. L'intention d'abord — Si l'intention de l'utilisateur n'est pas claire, confirmez ce qu'il veut avant de continuer.

Flux

Étape 1 : Vérification de la clé API

Si l'utilisateur n'a pas fourni de clé API ou défini EVOLINK_API_KEY :

Si la clé est déjà définie ou fournie, passez directement à l'Étape 2.

Étape 2 : Comprendre l'intention

Évaluez ce que l'utilisateur souhaite en fonction de son message :

  • L'intention est claire (par exemple, "Exécuter Nanobanana 2 Lite – Génération d'Images avec un prompt court") -> Aller à l'Étape 3
  • L'intention est ambiguë (par exemple, "Je veux essayer") -> Demandez ce qu'il aimerait faire.

Étape 3 : Collecter les informations manquantes

Vérifiez ce que l'utilisateur a déjà fourni et demandez uniquement ce qui manque :

ParamètreQuoi dire à l'utilisateurRequis ?
À définirÀ définirOui
À définirÀ définirOui
À définirÀ définirOptionnel
À définirÀ définirOptionnel

Règles strictes de collecte intelligente — STRICT :

  • Demandez TOUS les paramètres manquants en UN SEUL message. Ne divisez jamais en plusieurs tours de questions.
  • Ne posez jamais la même question deux fois. Si l'utilisateur a déjà répondu à un paramètre, il est définitif — ne redemandez pas.
  • Proposez les valeurs par défaut tout de suite pour que l'utilisateur puisse dire "les valeurs par défaut conviennent" : model=gemini-3.1-flash-lite-image, prompt='Créez une courte démo'. Si l'utilisateur dit "par défaut" ou "vas-y", utilisez ces valeurs immédiatement.
  • L'utilisateur donne tout en une fois -> Confirmez et exécutez le modèle immédiatement, sans autre question.
  • L'utilisateur donne des informations partielles -> Demandez uniquement les champs obligatoires restants, le tout dans un seul message.
  • Les paramètres optionnels ont tous des valeurs par défaut raisonnables — si l'utilisateur les ignore, utilisez les valeurs par défaut et continuez.

Étape 4 : Exécution

Une fois que toutes les informations requises sont confirmées :

  1. Avant d'exécuter le script, dites immédiatement à l'utilisateur : "Compris ! Je vais exécuter Nanobanana 2 Lite – Génération d'Images via EvoLink."
  2. Exécutez le script une fois. NE l'exécutez JAMAIS une deuxième fois sauf si l'utilisateur demande explicitement une nouvelle tentative.
  3. Une fois terminé, partagez le résultat et le temps écoulé.

Modèle d'exécution par agent

Claude Code — utilisez l'outil Bash avec run_in_background: true, puis lisez le fichier de sortie pour vérifier la progression :

# Étape 1 : Exécuter en arrière-plan (résout SKILL_DIR d'abord)
Bash(command: "{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh \"entrée\" --dry-run true", run_in_background: true, timeout: 300000)

# Étape 2 : Attendre ~30 secondes, puis lire le fichier de sortie de la tâche d'arrière-plan pour chercher des lignes RESULT_URL= ou STATUS_UPDATE

# Étape 3 : Lorsque vous voyez RESULT_URL=<valeur>, relayez-la à l'utilisateur

OpenClaw / OpenCode / Cursor — exécutez le script comme une commande shell bloquante (le script gère son propre polling en interne, se termine généralement en 2 à 10 minutes) :

EVOLINK_API_KEY=$EVOLINK_API_KEY {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "entrée" --dry-run true

Tous les agents — règles critiques :

  • Une fois que vous voyez TASK_SUBMITTED: dans la sortie, la tâche est déjà en file d'attente sur le serveur. N'exécutez PAS le script à nouveau — une nouvelle tentative gaspille les crédits API de l'utilisateur.
  • Le script bloque jusqu'à ce que la tâche soit prête (jusqu'à 5 minutes). Ne le tuez pas prématurément.
  • Si le script expire avec POLL_TIMEOUT, la tâche peut encore être en cours de traitement — dites à l'utilisateur de vérifier https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image.

Utilisation du script

Rappel : Remplacez {SKILL_DIR} par le répertoire réel contenant ce fichier SKILL.md.

# Définir la clé API
export EVOLINK_API_KEY=votre_clé_ici

# Basique
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Créez une courte démo de Nanobanana 2 Lite – Génération d'Images"

# Avec options
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Prompt de test" --dry-run true --timeout À_DÉFINIR

# Avancé
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Essai à sec" --help À_DÉFINIR

# Essai à sec (prévisualiser la charge utile sans appeler l'API)
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Test" --dry-run

Protocole de sortie du script

Le script écrit des lignes structurées sur stdout que vous devez analyser et traiter :

Format de ligneQuandVotre action
TASK_SUBMITTED: task_id=<id> estimated=<Ns>Juste après la soumissionConfirmez à l'utilisateur que la tâche a démarré. Cela signifie que l'appel API a réussi — ne réessayez PAS.
STATUS_UPDATE: <message>Toutes les ~15s pendant l'exécutionRelayez à l'utilisateur — par exemple, "Toujours en cours, environ 30 secondes restantes..."
RESULT_URL=<valeur>En cas de succèsExtrayez et présentez à l'utilisateur
ELAPSED=<Ns>En cas de succèsMentionnez éventuellement la durée
POLL_TIMEOUT: task_id=<id> dashboard=<url>Le polling a dépassé 5 minDites à l'utilisateur : "Votre tâche est peut-être déjà terminée — vérifiez <dashboard_url> (tâche : <id>)"
ERROR: ... (stderr)En cas d'échecAffichez le message d'erreur à l'utilisateur

Critique : Une fois que vous voyez TASK_SUBMITTED:, la tâche est en file d'attente sur le serveur. N'exécutez PAS le script à nouveau. Une nouvelle tentative gaspille les crédits API de l'utilisateur. Si le script expire localement, la tâche peut toujours se terminer — dites à l'utilisateur de vérifier son tableau de bord à https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image.

Gestion des erreurs

Fournissez des messages conviviaux et exploitables :

ErreurQuoi dire à l'utilisateur
Clé invalide/manquante (401)"Votre clé API ne semble pas fonctionner. Vous pouvez la vérifier à https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image"
Solde insuffisant (402)"Le solde de votre compte est faible. Vous pouvez ajouter des crédits à https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image"
Limite de débit atteinte (429)"Trop de requêtes — attendons un moment et réessayons"
Contenu bloqué (400)"Cette entrée a été signalée par la modération du contenu. Essayez de l'ajuster"
Service indisponible (503)"Le service est temporairement occupé. Réessayons dans une minute"

Résumé des capacités du modèle

Utilisez ceci lorsque l'utilisateur demande ce que le modèle peut faire :

  • Démarrage rapide de l'API : Créez une tâche, interrogez pour la complétion et inspectez la réponse finale.
  • Compétence d'agent : Utilisez SKILL.md plus les scripts pour guider l'exécution de l'agent.
  • Dépannage : Utilisez docs/errors.md et des exemples complets pour déboguer les échecs courants.
  • Préparation de version : Gardez les métadonnées du package cohérentes avant la publication publique.

Références

  • references/api-params.md : Référence complète des paramètres de l'API
  • scripts/nanobanana-2-lite-image.sh : Exécutez une tâche de génération d'images Nanobanana 2 Lite via EvoLink.

Skills associés