Generación de Imágenes Nanobanana 2 Lite
La generación de imágenes Nanobanana 2 Lite se expone aquí como un endpoint de la API de EvoLink con un skill de agente instalable correspondiente.
Cuándo Activar Esta Skill
Activa esta skill cuando el usuario solicite:
- Usar la generación de imágenes Nanobanana 2 Lite
- Ejecutar la generación de imágenes Nanobanana 2 Lite a través de EvoLink
- Generar una salida del modelo
- Probar el flujo de la API
Palabras clave: nanobanana-2-lite-image-generation, evolink, api, agent, skill
Ubicación del Script
IMPORTANTE: Todas las rutas de script en este archivo son relativas al directorio que contiene este archivo SKILL.md. Antes de ejecutar cualquier script, resuelve la ruta absoluta:
SKILL_DIR = directorio que contiene este archivo SKILL.md
Script = {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh
Por ejemplo, si este SKILL.md se encuentra en ~/.claude/skills/nanobanana-2-lite-image/SKILL.md, entonces el script está en ~/.claude/skills/nanobanana-2-lite-image/scripts/nanobanana-2-lite-image.sh.
Después de la Instalación
Cuando el skill se cargue por primera vez, saluda proactivamente al usuario e inicia la configuración:
-
Verifica si
EVOLINK_API_KEYestá configurada (ejecuta:echo $EVOLINK_API_KEY)- Si no está configurada: "Para ejecutar el modelo, necesitarás una clave de API de EvoLink. Abre https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image, crea una clave, luego pégala aquí y la configuraré para esta sesión."
- Si ya está configurada: "¡Estás listo! ¿Qué te gustaría hacer con la generación de imágenes Nanobanana 2 Lite?"
-
Eso es todo. Una pregunta. El usuario ya está en el flujo.
NO enumeres características, muestres un menú o vuelques instrucciones. Solo haz una pregunta para avanzar.
Principios Fundamentales
- Guía, no decidas — Presenta opciones y deja que el usuario decida. No asumas sus preferencias.
- Deja que el usuario dirija — Si tiene una idea, usa sus palabras. Si necesita inspiración, ofrece sugerencias y deja que elija o refine.
- Conciencia de contexto inteligente — Reconoce lo que el usuario ya ha proporcionado y solo pregunta sobre las piezas faltantes.
- Intención primero — Si la intención del usuario no está clara, confirma lo que quiere antes de proceder.
Flujo
Paso 1: Verificar la Clave de API
Si el usuario no ha proporcionado una clave de API o no ha configurado EVOLINK_API_KEY:
- Dile que necesita una clave de API de EvoLink
- Guíalo para que abra https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image y obtenga una clave desde el panel
- Una vez que proporcione una clave, continúa al Paso 2
Si la clave ya está configurada o proporcionada, salta directamente al Paso 2.
Paso 2: Entender la Intención
Evalúa lo que el usuario quiere según su mensaje:
- La intención es clara (ej., "Ejecuta la generación de imágenes Nanobanana 2 Lite con un prompt corto") -> Ve al Paso 3
- La intención es ambigua (ej., "Quiero probarlo") -> Pregunta qué le gustaría hacer.
Paso 3: Recopilar Información Faltante
Verifica lo que el usuario ya ha proporcionado y solo pregunta sobre lo que falta:
| Parámetro | Qué decir al usuario | ¿Obligatorio? |
|---|---|---|
| Pendiente | Pendiente | Sí |
| Pendiente | Pendiente | Sí |
| Pendiente | Pendiente | Opcional |
| Pendiente | Pendiente | Opcional |
Reglas de recopilación inteligente — ESTRICTAS:
- Pregunta TODOS los parámetros faltantes en UN SOLO mensaje. Nunca dividas en varias rondas de preguntas.
- Nunca preguntes lo mismo dos veces. Si el usuario ya respondió un parámetro, es definitivo — no lo vuelvas a preguntar.
- Ofrece valores predeterminados de inmediato para que los usuarios puedan decir "el predeterminado está bien":
model=gemini-3.1-flash-lite-image, prompt='Crea una demo corta'. Si el usuario dice "predeterminado" o "adelante", usa estos valores de inmediato. - El usuario lo da todo de una vez -> Confirma y ejecuta el modelo de inmediato, sin más preguntas.
- El usuario da información parcial -> Pregunta solo los campos obligatorios restantes, todo en un mensaje.
- Los parámetros opcionales tienen valores predeterminados sensatos — si el usuario los omite, usa los predeterminados y continúa.
Paso 4: Ejecutar
Una vez que toda la información requerida esté confirmada:
- Antes de ejecutar el script, dile inmediatamente al usuario: "¡Entendido! Ejecutaré la generación de imágenes Nanobanana 2 Lite a través de EvoLink."
- Ejecuta el script una vez. NUNCA lo ejecutes una segunda vez a menos que el usuario lo solicite explícitamente para reintentar.
- Cuando termine, comparte el resultado y el tiempo transcurrido.
Patrón de Ejecución por Agente
Claude Code — usa la herramienta Bash con run_in_background: true, luego lee el archivo de salida para verificar el progreso:
# Paso 1: Ejecutar en segundo plano (resuelve SKILL_DIR primero)
Bash(command: "{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh \"input\" --dry-run true", run_in_background: true, timeout: 300000)
# Paso 2: Espera ~30 segundos, luego lee el archivo de salida de la tarea en segundo plano para buscar líneas RESULT_URL= o STATUS_UPDATE
# Paso 3: Cuando veas RESULT_URL=<valor>, transmíteselo al usuario
OpenClaw / OpenCode / Cursor — ejecuta el script como un comando de shell bloqueante (el script maneja su propio sondeo internamente, normalmente se completa en 2-10 minutos):
EVOLINK_API_KEY=$EVOLINK_API_KEY {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "input" --dry-run true
Todos los agentes — reglas críticas:
- Una vez que veas
TASK_SUBMITTED:en la salida, la tarea ya está en cola en el servidor. NO ejecutes el script de nuevo — reintentar desperdicia los créditos de API del usuario. - El script se bloquea hasta que la tarea esté lista (hasta 5 minutos). NO lo mates prematuramente.
- Si el script expira con
POLL_TIMEOUT, la tarea aún puede estar procesándose — dile al usuario que revise https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image.
Uso del Script
Recuerda: Reemplaza {SKILL_DIR} con el directorio real que contiene este archivo SKILL.md.
# Configurar clave de API
export EVOLINK_API_KEY=tu_clave_aqui
# Básico
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Crea una demo corta de generación de imágenes Nanobanana 2 Lite"
# Con opciones
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Prompt de prueba" --dry-run true --timeout Pendiente
# Avanzado
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Ejecución en seco" --help Pendiente
# Ejecución en seco (previsualizar carga útil sin llamar a la API)
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "Prueba" --dry-run
Protocolo de Salida del Script
El script escribe líneas estructuradas en stdout que debes analizar y en las que debes actuar:
| Formato de línea | Cuándo | Tu acción |
|---|---|---|
TASK_SUBMITTED: task_id=<id> estimated=<Ns> | Justo después del envío | Confirma al usuario que la tarea ha comenzado. Esto significa que la llamada a la API fue exitosa — NO reintentes. |
STATUS_UPDATE: <mensaje> | Cada ~15s durante la ejecución | Transmite al usuario — ej., "Todavía trabajando, aproximadamente 30 segundos restantes..." |
RESULT_URL=<valor> | En caso de éxito | Extrae y presenta al usuario |
ELAPSED=<Ns> | En caso de éxito | Opcionalmente menciona cuánto tiempo tomó |
POLL_TIMEOUT: task_id=<id> dashboard=<url> | El sondeo superó los 5 min | Dile al usuario: "Tu tarea puede que ya esté lista — revisa <dashboard_url> (tarea: <id>)" |
ERROR: ... (stderr) | En caso de fallo | Muestra el mensaje de error al usuario |
Crítico: Una vez que veas TASK_SUBMITTED:, la tarea está en cola en el servidor. NO ejecutes el script de nuevo. Reintentar desperdicia los créditos de API del usuario. Si el script expira localmente, la tarea puede completarse de todos modos — dile al usuario que revise su panel en https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image.
Manejo de Errores
Proporciona mensajes amigables y procesables:
| Error | Qué decir al usuario |
|---|---|
| Clave inválida/faltante (401) | "Tu clave de API no parece funcionar. Puedes revisarla en https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image" |
| Saldo insuficiente (402) | "El saldo de tu cuenta es bajo. Puedes agregar créditos en https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image" |
| Límite de velocidad excedido (429) | "Demasiadas solicitudes — esperemos un momento y lo intentemos de nuevo" |
| Contenido bloqueado (400) | "Esta entrada fue marcada por la moderación de contenido. Intenta ajustarla" |
| Servicio no disponible (503) | "El servicio está temporalmente ocupado. Intentemos de nuevo en un minuto" |
Resumen de Capacidades del Modelo
Úsalo cuando el usuario pregunte qué puede hacer el modelo:
- Inicio rápido de la API: Crea una tarea, sondea hasta que se complete e inspecciona la respuesta final.
- Skill de agente: Usa SKILL.md más scripts para guiar la ejecución del agente.
- Solución de problemas: Usa docs/errors.md y ejemplos completos para depurar fallos comunes.
- Preparación del lanzamiento: Mantén los metadatos del paquete consistentes antes del lanzamiento público.
Referencias
references/api-params.md: Referencia completa de parámetros de la APIscripts/nanobanana-2-lite-image.sh: Ejecuta una tarea de generación de imágenes Nanobanana 2 Lite a través de EvoLink.