Generación y Edición de Imágenes con Nano Banana 2
Genera nuevas imágenes o edita imágenes existentes usando la API de Google Nano Banana 2 (Gemini 3.1 Flash Image).
Uso
Ejecuta el script usando la ruta absoluta (NO cambies al directorio del skill primero):
Generar nueva imagen:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "descripción de tu imagen" --filename "nombre-salida.png" [--resolution 512|1K|2K|4K] [--api-key KEY]
Editar imagen existente:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "instrucciones de edición" --filename "nombre-salida.png" --input-image "ruta/a/imagen.png" [--resolution 512|1K|2K|4K] [--api-key KEY]
Importante: Ejecuta siempre desde el directorio de trabajo actual del usuario para que las imágenes se guarden donde el usuario está trabajando, no en el directorio del skill.
Flujo de Trabajo Predeterminado (borrador → iterar → final)
Objetivo: iteración rápida sin malgastar tiempo en 4K hasta que el prompt esté correcto.
- Borrador (1K): ciclo de retroalimentación rápido
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<prompt del borrador>" --filename "yyyy-mm-dd-hh-mm-ss-borrador.png" --resolution 1K
- Iterar: ajusta el prompt con pequeños cambios; mantén un nombre de archivo nuevo por cada ejecución
- Si estás editando: usa el mismo
--input-imageen cada iteración hasta que estés conforme.
- Si estás editando: usa el mismo
- Final (4K): solo cuando el prompt esté bloqueado
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<prompt final>" --filename "yyyy-mm-dd-hh-mm-ss-final.png" --resolution 4K
Opciones de Resolución
La API de Gemini 3.1 Flash Image admite estos valores de tamaño de salida:
- 512 - compacto ~512px de resolución
- 1K (por defecto) - ~1024px de resolución
- 2K - ~2048px de resolución
- 4K - ~4096px de resolución
Mapea las solicitudes del usuario a parámetros de la API:
- "512", "512px", "0.5K", "thumbnail", "pequeño" →
512 - Sin mención de resolución →
1K - "baja resolución", "1080", "1080p", "1K" →
1K - "2K", "2048", "normal", "resolución media" →
2K - "alta resolución", "alta-res", "hi-res", "4K", "ultra" →
4K
Clave API
El script verifica la clave API en este orden:
- Argumento
--api-key(úsalo si el usuario proporcionó la clave en el chat) - Variable de entorno
GEMINI_API_KEY
Si no hay ninguna disponible, el script termina con un mensaje de error.
Verificación Previa y Fallos Comunes (soluciones rápidas)
-
Verificación previa:
command -v uv(debe existir)test -n "$GEMINI_API_KEY"(o pasar--api-key)- Si se edita:
test -f "ruta/a/imagen.png"
-
Fallos comunes:
Error: No API key provided.→ estableceGEMINI_API_KEYo pasa--api-keyError loading input image:→ ruta incorrecta / archivo ilegible; verifica que--input-imageapunte a una imagen real- Errores de API tipo “cuota/permiso/403” → clave incorrecta, sin acceso o cuota excedida; prueba con una clave/cuenta diferente
Generación de Nombre de Archivo
Genera nombres de archivo con el patrón: yyyy-mm-dd-hh-mm-ss-nombre.png
Formato: {marca-de-tiempo}-{nombre-descriptivo}.png
- Marca de tiempo: Fecha/hora actual en formato
yyyy-mm-dd-hh-mm-ss(formato 24 horas) - Nombre: Texto descriptivo en minúsculas con guiones
- Mantén la parte descriptiva concisa (normalmente 1-5 palabras)
- Usa el contexto del prompt del usuario o la conversación
- Si no está claro, usa un identificador aleatorio (ej.,
x9k2,a7b3)
Ejemplos:
- Prompt "Un jardín japonés sereno" →
2025-11-23-14-23-05-jardin-japones.png - Prompt "atardecer sobre montañas" →
2025-11-23-15-30-12-atardecer-montañas.png - Prompt "crea una imagen de un robot" →
2025-11-23-16-45-33-robot.png - Contexto no claro →
2025-11-23-17-12-48-x9k2.png
Edición de Imágenes
Cuando el usuario quiera modificar una imagen existente:
- Verifica si proporciona una ruta de imagen o hace referencia a una imagen en el directorio actual
- Usa el parámetro
--input-imagecon la ruta a la imagen - El prompt debe contener instrucciones de edición (ej., "haz el cielo más dramático", "elimina a la persona", "cambia a estilo caricatura")
- Tareas de edición comunes: añadir/eliminar elementos, cambiar estilo, ajustar colores, desenfocar fondo, etc.
Manejo del Prompt
Para generación: Pasa la descripción de la imagen del usuario tal cual a --prompt. Solo reescribe si es claramente insuficiente.
Para edición: Pasa las instrucciones de edición en --prompt (ej., "añade un arcoíris en el cielo", "haz que parezca una acuarela")
Preserva la intención creativa del usuario en ambos casos.
Plantillas de Prompt (alta tasa de acierto)
Usa las plantillas cuando el usuario sea vago o cuando las ediciones deban ser precisas.
-
Plantilla de generación:
- "Crea una imagen de: . Estilo: . Composición: <cámara/toma>. Iluminación: <iluminación>. Fondo: . Paleta de colores: . Evita: ."
-
Plantilla de edición (conserva todo lo demás):
- "Cambia SOLO: <cambio único>. Mantén idéntico: sujeto, composición/encuadre, pose, iluminación, paleta de colores, fondo, texto y estilo general. No añadas nuevos objetos. Si hay texto, mantenlo sin cambios."
Salida
- Guarda PNG en el directorio actual (o en la ruta especificada si el nombre de archivo incluye un directorio)
- El script muestra la ruta completa de la imagen generada
- No leas la imagen de vuelta - solo informa al usuario de la ruta guardada
Ejemplos
Generar nueva imagen:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "Un jardín japonés sereno con cerezos en flor" --filename "2025-11-23-14-23-05-jardin-japones.png" --resolution 4K
Editar imagen existente:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "haz el cielo más dramático con nubes de tormenta" --filename "2025-11-23-14-25-30-cielo-dramatico.png" --input-image "foto-original.jpg" --resolution 2K