Introducción
Nano Banana Pro Edición de imagen ejecuta el Gemini 3 Pro Image de Google sobre imágenes que ya tienes. Acepta de una a catorce imágenes de origen, planea la edición antes de generarla y devuelve 1k, 2k o 4k en el formato de origen o en uno de diez formatos.
Elige el modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | Nano Banana Pro Texto a imagen |
| una imagen que quieres cambiar | Nano Banana Pro Edición de imagen |
Funciones y aspectos destacados
Ediciones cuidadosas de un solo cambio
Nueva luz, un fondo nuevo o texto añadido mientras las personas y el resto del cuadro quedan como estaban, como en nuestros ejemplos de velas y de portada. El modelo planea la edición antes de generarla, lo que mantiene estables las partes del cuadro que no cambian.
Texto sobre fotos
Cabeceras, líneas de edición y pies de foto se colocan sobre la imagen con la ortografía que citas y en la posición que indicas.
Hasta catorce referencias
Combina personas, productos y escenarios de muchas imágenes de origen, cada una descrita por su papel en el prompt, en una sola solicitud de edición.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5.000 caracteres. Describe el sujeto, el escenario, la luz y el lente con frases completas; las palabras entre comillas se escriben como texto en la imagen. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | De 1 a 14 imágenes de origen. Indica en el prompt qué aporta cada una: la persona, el escenario, el producto. mínimo 1 elementos · máximo 14 elementos |
aspect_ratio | No | auto (predeterminado) conserva el formato de la imagen de origen; o elige uno de diez formatos de 21:9 a 9:16. El formato no cambia el precio. |
resolution | No | 1k (predeterminado), 2k o 4k. 1k y 2k cuestan lo mismo; 4k cuesta más y genera 4096 píxeles en el lado largo. |
official_fallback | No | Activado por defecto. Cada edición se ejecuta primero por la ruta económica. Valor predeterminado: |
Precios
Se cobra por imagen según el nivel de tamaño. Cada edición empieza en la ruta económica, al precio económico, sin cargo por imagen de origen. Con Official fallback (activado de forma predeterminada), una edición que la ruta económica rechaza o no puede completar, o una con más de 8 imágenes de origen, pasa por la ruta oficial al precio oficial, que además suma un pequeño cargo fijo por cada imagen de origen; desactívalo para pagar solo el precio económico. La cotización muestra el precio inicial y el monto máximo de la edición. Las solicitudes rechazadas no se cobran.
| Especificación | Precio |
|---|---|
| $0.0668 / imagen (Con Official fallback: hasta $0.1072) |
| $0.0668 / imagen (Con Official fallback: hasta $0.1072) |
| $0.118 / imagen (Con Official fallback: hasta $0.192) |
Casos de uso
Convierte fotos en portadas y pósteres
Añade una cabecera, una fecha y una línea de texto a una foto aprobada sin retocarla.
Variaciones de ambiente y luz
Muestra la misma escena con velas, al amanecer o bajo neón para un cliente que está eligiendo una dirección.
Imágenes de campaña localizadas
Reemplaza el texto de un póster terminado por una línea traducida para cada mercado mientras la foto y su luz quedan intactas.
Guía de prompts y consejos prácticos
Cambia una cosa a la vez
Las instrucciones con un solo cambio mantienen estable todo lo demás; encadena varias ediciones en lugar de meterlas en un solo prompt.
Protege a las personas
Después del cambio, nombra a la persona, el atuendo y la pose que deben quedar exactamente iguales.
Calcula tiempo para las ediciones
Con este modelo las ediciones tardan más que texto a imagen: hasta unos tres minutos en nuestras pruebas en 2k en la ruta oficial, mientras que nuestras ediciones en 1k en la ruta económica terminaron en menos de un minuto.
Cita el texto con su posición
Para texto añadido, cita cada línea e indica dónde va: arriba, abajo a la izquierda, junto al logotipo.
Usa 2k como predeterminado
Con este modelo 1k y 2k cuestan lo mismo, así que edita en 2k salvo que necesites un archivo más pequeño.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-pro/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
