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 :
-
Vérifiez si
EVOLINK_API_KEYest défini (exécutez :echo $EVOLINK_API_KEY)- Si non défini : "Pour exécuter le modèle, vous aurez besoin d'une clé API EvoLink. Ouvrez https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image, créez une clé, puis collez-la ici et je la définirai pour cette session."
- Si déjà défini : "Tout est prêt ! Que souhaitez-vous faire avec Nanobanana 2 Lite – Génération d'Images ?"
-
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
- 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.
- 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.
- Conscience intelligente du contexte — Reconnaissez ce que l'utilisateur a déjà fourni et ne demandez que les éléments manquants.
- 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 :
- Dites-lui qu'il a besoin d'une clé API EvoLink
- Guidez-le pour ouvrir https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image et obtenir une clé depuis le tableau de bord
- Une fois la clé fournie, passez à l'Étape 2
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ètre | Quoi dire à l'utilisateur | Requis ? |
|---|---|---|
| À définir | À définir | Oui |
| À définir | À définir | Oui |
| À définir | À définir | Optionnel |
| À définir | À définir | Optionnel |
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 :
- 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."
- Exécutez le script une fois. NE l'exécutez JAMAIS une deuxième fois sauf si l'utilisateur demande explicitement une nouvelle tentative.
- 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 ligne | Quand | Votre action |
|---|---|---|
TASK_SUBMITTED: task_id=<id> estimated=<Ns> | Juste après la soumission | Confirmez à 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écution | Relayez à l'utilisateur — par exemple, "Toujours en cours, environ 30 secondes restantes..." |
RESULT_URL=<valeur> | En cas de succès | Extrayez et présentez à l'utilisateur |
ELAPSED=<Ns> | En cas de succès | Mentionnez éventuellement la durée |
POLL_TIMEOUT: task_id=<id> dashboard=<url> | Le polling a dépassé 5 min | Dites à l'utilisateur : "Votre tâche est peut-être déjà terminée — vérifiez <dashboard_url> (tâche : <id>)" |
ERROR: ... (stderr) | En cas d'échec | Affichez 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 :
| Erreur | Quoi 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'APIscripts/nanobanana-2-lite-image.sh: Exécutez une tâche de génération d'images Nanobanana 2 Lite via EvoLink.