Communitygithub.com

Evolink-AI/nanobanana-2-lite-image-generate-api-skill

Ejemplos de la API de generación de imágenes Nanobanana 2 Lite y skill de agente instalable para EvoLink.

¿Qué es nanobanana-2-lite-image-generate-api-skill?

Esta skill expone el endpoint de la API de generación de imágenes Nanobanana 2 Lite como un skill de agente instalable para EvoLink. Permite a un desarrollador o usuario de un agente de IA (como Claude Code, Cursor, Codex, etc.) generar imágenes utilizando el modelo Nanobanana 2 Lite directamente desde la línea de comandos o mediante un agente. El skill proporciona un script shell que maneja la autenticación (requiere una clave de API de EvoLink), el envío de la solicitud, el sondeo periódico del estado de la tarea y la recuperación de la URL del resultado. Es útil para automatizar flujos de generación de imágenes, probar la API de EvoLink o integrar la generación de imágenes en herramientas de desarrollo. La skill también incluye un protocolo de salida estructurado para que el agente pueda interpretar el progreso de la tarea y actuar en consecuencia.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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:

  1. Verifica si EVOLINK_API_KEY está configurada (ejecuta: echo $EVOLINK_API_KEY)

  2. 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

  1. Guía, no decidas — Presenta opciones y deja que el usuario decida. No asumas sus preferencias.
  2. Deja que el usuario dirija — Si tiene una idea, usa sus palabras. Si necesita inspiración, ofrece sugerencias y deja que elija o refine.
  3. Conciencia de contexto inteligente — Reconoce lo que el usuario ya ha proporcionado y solo pregunta sobre las piezas faltantes.
  4. 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:

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ámetroQué decir al usuario¿Obligatorio?
PendientePendienteSí
PendientePendienteSí
PendientePendienteOpcional
PendientePendienteOpcional

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:

  1. 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."
  2. Ejecuta el script una vez. NUNCA lo ejecutes una segunda vez a menos que el usuario lo solicite explícitamente para reintentar.
  3. 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:

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íneaCuándoTu acción
TASK_SUBMITTED: task_id=<id> estimated=<Ns>Justo después del envíoConfirma 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ónTransmite al usuario — ej., "Todavía trabajando, aproximadamente 30 segundos restantes..."
RESULT_URL=<valor>En caso de éxitoExtrae y presenta al usuario
ELAPSED=<Ns>En caso de éxitoOpcionalmente menciona cuánto tiempo tomó
POLL_TIMEOUT: task_id=<id> dashboard=<url>El sondeo superó los 5 minDile al usuario: "Tu tarea puede que ya esté lista — revisa <dashboard_url> (tarea: <id>)"
ERROR: ... (stderr)En caso de falloMuestra 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:

ErrorQué 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 API
  • scripts/nanobanana-2-lite-image.sh: Ejecuta una tarea de generación de imágenes Nanobanana 2 Lite a través de EvoLink.

Skills relacionados