← Prompts · Recursos

Conectá Claude Code a nano-banana.

Todas las ilustraciones de este sitio salen de esta conexión: Claude Code hablando por API con nano-banana (el generador de imágenes de Google) vía Replicate. Acá está el sistema completo, paso a paso, con los prompts exactos — en ~15 minutos tenés tu propia máquina de imágenes.

◆ GENERADAS CON ESTE SISTEMA · sin retoques
Robot voxel generado con nano-banana Mono voxel pintor generado con nano-banana Set de cine voxel generado con nano-banana Teclado voxel generado con nano-banana

Por qué este sistema

Pagás por imagenCentavos por generación, sin mensualidad. Usás cuando necesitás.
Se automatizaClaude Code genera 1 o 40 imágenes solo — vos escribís la lista de escenas.
Estilo consistenteCon la fórmula de marca, todas salen del mismo universo visual.

El stack

Replicatela plataforma que aloja nano-banana y te cobra por uso (replicate.com)
Claude Codeescribe el script, lo corre y maneja los errores — vos no tocás código
Una carpetatu "estudio de imágenes": ahí viven el script, el token y los PNG
Paso 01⏱ ~3 min

Creá la cuenta y el token en Replicate

Entrá a replicate.com, creá una cuenta y andá a Account → API tokens. Creá un token nuevo (dale un nombre tipo "imagenes") y copialo — empieza con r8_. Cargás un método de pago y pagás por imagen, sin mensualidad.

Las dos versiones del modelo y cuánto consume cada una (esto es lo que yo uso, con precios de referencia — confirmalos en la página de cada modelo):

google/nano-bananaGemini 2.5 Flash Image · ≈ $0.039 por imagen · rápida y barata: para iterar ideas, bocetos y volumen.
google/nano-banana-proGemini 3 Pro Image · ≈ $0.134 por imagen en 1K/2K y $0.24 en 4K · la que uso para piezas finales: texto legible dentro de la imagen y personaje consistente. Las escenas de mis carruseles salen de acá (un carrusel de 6 escenas ≈ $0.80–$1 con reintentos).
⚠ La única regla sagrada: ese token es tu tarjeta. No lo pegues en chats públicos, capturas ni código que subas a internet. En el paso 2 lo guardamos donde corresponde.
Paso 02⏱ ~2 min

Armale la casa: carpeta + archivo .env

Creá una carpeta nueva (ej: mi-estudio-ia) y abrí Claude Code apuntando a ella. Primer prompt:

prompt-paso-2.txt
> Creá un archivo .env con la variable REPLICATE_API_TOKEN=(acá pego mi token). Creá también un .gitignore que excluya el .env. Explicame en una línea por qué el token va ahí y no en el código.

Resultado esperado: dos archivos creados. El .env es la caja fuerte: el script lo lee, pero nunca viaja con el código.

Paso 03⏱ ~3 min

Pedíle el script generador

Este es el prompt que crea la máquina. Pegálo tal cual:

prompt-paso-3.txt
> Escribí un script en Python llamado generar.py que use la API de Replicate con el modelo google/nano-banana-pro. Que: (1) lea REPLICATE_API_TOKEN del .env, (2) reciba el prompt de la imagen y el aspect ratio como argumentos, (3) haga el POST al endpoint de predictions y espere con polling hasta que termine, (4) descargue el resultado como PNG con nombre automático. Manejá errores con mensajes claros. Después explicame cómo correrlo.

Resultado esperado: un archivo generar.py y la explicación de uso. Claude instala solo lo que falte (requests, dotenv).

💡 Dato técnico por si lo querés ver: el endpoint es POST api.replicate.com/v1/models/google/nano-banana-pro/predictions con tu token en el header y un JSON {"input":{"prompt":"...","aspect_ratio":"4:3","output_format":"png"}}. Pero no necesitás saberlo — Claude lo escribe.
Paso 04⏱ ~1 min

Generá tu primera imagen

Pedíle a Claude: "corré generar.py con este prompt: un gato astronauta flotando, estilo ilustración retro". La generación tarda entre 10 y 40 segundos y el PNG queda en tu carpeta.

🔧 Si algo falla: no debugues vos. Copiá el error completo y pegáselo a Claude con "arreglalo". Ese loop — error → pegar → arreglar — es el 80% de trabajar con IA.
Paso 05⏱ ~5 min

Dale identidad de marca

Una imagen linda es fácil; un universo visual es lo que construye marca. La fórmula que uso en todas las imágenes de este sitio: estilo con nombre + personaje y acción + paleta cerrada de 3 colores + textura de impresión + "sin texto". La plantilla completa rellenable está en imágenes que no parecen de IA — usála como prompt base y solo cambiá la escena.

Paso 06⏱ ~5 min

Escalá: lotes y personaje consistente

Acá es donde la conexión paga el esfuerzo. Dos jugadas:

Lotes: pedíle a Claude "modificá generar.py para que lea una lista de escenas de un archivo escenas.txt y genere todas las imágenes de corrido". Escribís 10 líneas, volvés con 10 imágenes.

Personaje consistente (img2img): nano-banana acepta una imagen de referencia. Pedíle: "agregá soporte para mandar una imagen de referencia en base64 con image_input, así el personaje se mantiene entre escenas". Así nacieron mi avatar y el mono de este sitio: mi avatar es literalmente mi selfie mandada como image_input a nano-banana-pro con un prompt de estilo voxel — y cada escena nueva vuelve a mandar el avatar como referencia para que el personaje sea siempre el mismo.

💡 Dos trucos de producción que valen oro: (1) si la escena lleva texto, usá frases CORTAS en MAYÚSCULAS y cerrá el prompt con Spelling exactly as written — y si igual sale con letras inventadas, regenerá (pasa ≈1 de cada 4, máximo 2 reintentos); (2) el "fondo transparente" del modelo no existe: el PNG trae fondo pintado — se quita DESPUÉS con un script de flood-fill (prompt 4 del pack).

Lo que tenés al terminar

Llevate el pack completo de prompts

Los 3 prompts largos (script completo, plantilla de estilo y lote+img2img) listos para copiar y pegar, con los detalles finos.

★ · El pack completo

pack-1-script-completo.txt
> Escribí generar.py en Python para la API de Replicate. Modelos: google/nano-banana-pro por defecto (Gemini 3 Pro Image, ≈$0.134 por imagen en 1K/2K, la de calidad final) y un parámetro --rapido que cambia a google/nano-banana (Gemini 2.5 Flash Image, ≈$0.039 por imagen, para iterar barato). Requisitos: lee REPLICATE_API_TOKEN de .env con python-dotenv (override=True); recibe prompt, aspect_ratio (default 4:3; 16:9 para panorámicas) y nombre de salida como argumentos; hace POST a api.replicate.com/v1/models/(modelo)/predictions con header Prefer: wait y si aún no termina hace polling cada 3 segundos leyendo urls.get; al terminar descarga la imagen y la guarda como PNG; convierte a WebP calidad 82 si pesa más de 200 KB; imprime el costo estimado según el modelo usado y la ruta final. Errores con mensajes en español claros.
pack-2-plantilla-estilo.txt
> A partir de ahora, todas las imágenes que generé usan esta base de estilo y solo cambia la ESCENA: Ilustración [TU ESTILO CON NOMBRE, ej: voxel isométrica 3D estilo Minecraft]. [ESCENA: personaje + acción + objetos]. Paleta estricta: [COLOR 1 con nombre y hex], [COLOR 2] y [COLOR 3] — solo esos, el personaje mantiene su piel natural. Renderizado como impreso en papel con grano risograph, estética de póster. Escena centrada, UN solo foco visual. Sin texto, sin letras, sin marca de agua. Y cuando la escena SÍ lleve texto: frases cortas en MAYÚSCULAS con el contenido exacto entre comillas + la frase final "Spelling exactly as written".
pack-3-lote-img2img.txt
> Modificá generar.py: (1) modo lote — si le paso escenas.txt, genera una imagen por línea aplicando la plantilla de estilo base automáticamente, nombrando cada archivo por su línea; (2) modo referencia — parámetro opcional --ref imagen.png que la envía en base64 dentro de image_input (lista) para mantener el personaje consistente entre escenas — así se hace un avatar: tu selfie como --ref + prompt del estilo; (3) al final genera una hoja de contactos (grilla) con todas las imágenes del lote usando Pillow.
pack-4-fondo-transparente.txt
> Escribí fix_fondo.py con Pillow: recibe un PNG generado y le quita el fondo DE VERDAD — flood-fill desde los 4 bordes con tolerancia 10 convirtiendo a alpha 0, segunda pasada con tolerancia 18 para los restos, y guarda como (nombre)_alpha.png conservando el resto intacto. Explicame en 2 líneas por qué superponer la imagen con mix-blend-mode multiply NO es quitar el fondo (deja el rectángulo visible apenas el fondo de atrás no coincide).

Regla de oro del pack: el estilo se define UNA vez (pack 2) y después solo escribís escenas. Si cada imagen redefine el estilo, el universo se rompe.

Mi hoja de producción real (lo que corre detrás de cada imagen de este sitio): nano-banana-pro para finales / nano-banana para bocetos · 16:9 en panorámicas de portada y 4:3 en escenas · personaje = avatar como image_input en TODAS las escenas · texto en imagen = corto, MAYÚSCULAS, "Spelling exactly as written", regenerar si sale inventado (máx 2 reintentos) · fondo = flood-fill a alpha real (pack 4), nunca multiply · presupuesto: escena final ≈$0.134, carrusel completo ≈$1.

¿Generaste tu universo?

Mostráme tus imágenes por DM — comparto las mejores. Cada semana sale un sistema nuevo.

Seguir @soydanielcastrillon