Guía de uso
Guía de generación de imágenes a partir de texto con Nano Banana Basic: formato, espacio en blanco y uso de prompts
Use los campos aspect_ratio y prompt de la interfaz de tareas para generar imágenes con composición clara para pancartas y tarjetas sociales
En esta página
Posicionamiento y límites de esta línea
nano-banana es una línea de generación de imágenes a partir de texto (text-to-image) en HiAPI, que se envía como tarea asíncrona: los campos de entrada del cuerpo de la solicitud se agrupan bajo el objeto input y, tras el envío, el resultado se recupera como una tarea. Es adecuada para escenarios con necesidades de ilustración por lotes, como pancartas operativas, tarjetas sociales o borradores de imágenes para artículos. Este artículo solo trata la versión básica y no cubre otros modelos de la misma serie.
Los campos disponibles son pocos, así que conviene dejar claro el contrato: prompt es una cadena obligatoria de 1 a 5000 caracteres; aspect_ratio es opcional, su valor predeterminado es auto y sus valores de enumeración son auto, 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9; output_format es opcional y puede ser png o jpeg, con png como valor predeterminado. El campo antiguo image_size está obsoleto; para especificar el formato objetivo, use aspect_ratio.
Cabe aclarar que esta línea no expone campos como resolution, quality, width, height, seed ni carga de imágenes de referencia. No introduzca esas claves en input siguiendo las costumbres de otros modelos de imagen, ni asuma que se ignorarán silenciosamente. Del mismo modo, aspect_ratio sirve para especificar la proporción del formato objetivo y no garantiza un tamaño fijo en píxeles; el formato y los píxeles reales deben verificarse en la imagen devuelta antes de la entrega.

Contrato de campos y un fragmento mínimo de input
A continuación se muestra un fragmento de input que solo contiene los campos mencionados, para ilustrar la jerarquía de campos. No es una solicitud HTTP completa: no se incluyen el endpoint, las cabeceras de autenticación ni el método de sondeo de la tarea; consulte la documentación de la interfaz de HiAPI para esos aspectos.
{
"input": {
"prompt": "Ilustración geométrica plana de composición horizontal, fondo beige cálido, el tercio derecho con bloques escalonados, el lado izquierdo en blanco, sin texto en la imagen.",
"aspect_ratio": "16:9",
"output_format": "png"
}
}
La forma de redactar el prompt afecta el grado de control de la imagen. Un orden práctico es: primero el sujeto y la escena, luego la composición y la posición del sujeto, después la zona de espacio en blanco y, por último, el color, la luz y el estilo. Si no se desea texto en la imagen, indicar explícitamente «no debe aparecer ningún texto, letra ni número en la imagen» ahorra más trabajo que retocar después. No es necesario alcanzar los 5000 caracteres; basta con expresar claramente las restricciones clave, ya que una acumulación excesiva diluye las prioridades.
La elección de output_format depende de la cadena de entrega: png es adecuado para guardado sin pérdida y edición posterior; jpeg es adecuado para entregas con compresión con pérdida. El valor predeterminado es png; si el destino es sensible al tamaño, recuerde cambiarlo explícitamente a jpeg. Cabe señalar que poder elegir png no significa que el modelo genere un canal alfa transparente; esta línea no declara ni expone capacidad de fondo transparente, y no garantiza eliminación de fondo ni salida transparente.
Formato y espacio en blanco: primero el diseño, luego el prompt
El espacio en blanco no es «dejar vacío», sino reservar lugar para títulos, botones o distintivos. La estrategia de espacio en blanco varía según el formato; al redactar el prompt, describa el espacio en blanco como parte de la composición.
- Pancarta 16:9: habitual en cabeceras de sitios y portadas de artículos. Se recomienda desplazar el sujeto hacia el tercio derecho o izquierdo y dejar en el otro lado una zona continua de baja información, evitando que el sujeto tape el título. En el prompt se puede escribir «reservar en el lado izquierdo una zona de bajo contraste de aproximadamente un tercio del ancho».
- Tarjeta social 1:1: sujeto centrado, con un margen de respiro arriba y abajo; los elementos de los bordes no deben pegarse al borde para evitar recortes en el flujo de información.
- Vertical 9:16: dejar una franja arriba y otra abajo para el título y la firma; colocar el sujeto en la parte central para que no se superponga con las zonas de texto de los extremos.
- 4:5 y 3:4: proporciones habituales en impresión y flujos de información; el espacio en blanco puede ser menor, pero se recomienda mantener un margen de seguridad en los cuatro lados.
- Ultrapanorámico 21:9: hay espacio horizontal de sobra, ideal para ritmar varios elementos, pero los extremos se recortan con facilidad; no pegue el sujeto principal a los bordes.
- auto: el servidor decide la proporción; útil en exploración temprana. Una vez en producción por lotes, se recomienda especificar la proporción explícitamente para reducir retrabajos de diseño.
Hay que insistir: proporción no es lo mismo que píxeles. aspect_ratio define la proporción del formato objetivo; 16:9 no implica un tamaño fijo en píxeles (por ejemplo, 1920×1080). Tras recibir la imagen, verifique si el formato real cumple lo esperado; si el destino exige dimensiones estrictas, escale o recorte usted mismo y deje suficiente margen de seguridad ya en la fase de prompt.
Dos ejemplos de prompt directamente adaptables
Los dos textos siguientes son propuestas pendientes de validación, no conclusiones de pruebas reales. Se recomienda llamar una vez a cada uno, observar si la posición del sujeto y el espacio en blanco cumplen lo esperado y luego ajustarlos según el proyecto.
Espacio en blanco para pancarta (16:9):
«Ilustración geométrica plana de composición horizontal, fondo beige cálido. En el tercio derecho de la imagen, colocar un conjunto de estructuras escalonadas formadas por bloques de color terracota, ocre y marrón oscuro, que descienden gradualmente de izquierda a derecha, con bordes limpios; los dos tercios izquierdos de la imagen deben mantener una zona de espacio en blanco de bajo contraste y sin detalles, conservando solo una franja horizontal muy tenue como transición. Tonalidad general contenida, sin ruido de degradado, sin texto, letras, números ni logotipos, composición equilibrada, adecuada como imagen de cabecera de artículo.»
Tarjeta social (1:1):
«Ilustración minimalista de composición cuadrada, fondo beige claro. En el centro de la imagen, colocar una marca abstracta formada por la superposición de tres arcos, en colores verde tinta oscuro y ocre, con grosor de línea uniforme; alrededor de la marca, dejar un espacio en blanco uniforme, algo mayor arriba y abajo que a los lados, para facilitar la superposición posterior del título. Fondo limpio, sin texturas, sin sombras, sin texto, letras, números ni logotipos, ambiente tranquilo y contenido.»
Ambos prompts describen el «espacio en blanco» como una descripción espacial ejecutable, no como una frase de «dejar más espacio en blanco». Si el sujeto generado sigue pegado al borde, ajuste primero las palabras de orientación y los porcentajes de la descripción, en lugar de añadir adjetivos sin fin.
Iteración paso a paso: cambiar solo una variable a la vez
El error más común al generar imágenes por lotes es cambiar a la vez el prompt, la proporción y el formato, y luego no poder determinar qué causó el cambio. Un enfoque más estable es converger por pasos.
- Primer paso: fijar aspect_ratio y output_format, y usar un prompt corto para confirmar si el sujeto se interpreta correctamente.
- Segundo paso: añadir la descripción de la composición: posición del sujeto, proporción del encuadre y zona de espacio en blanco.
- Tercer paso: complementar color, luz y estilo, y observar si comprimen el espacio en blanco.
- Cuarto paso: organizar la descripción estabilizada en una plantilla; en el procesamiento por lotes, sustituir solo el sujeto y la paleta, sin modificar las frases estructurales.
Después de cada llamada, registre las diferencias entre prompt, aspect_ratio, output_format y el resultado. El registro en sí es un activo: cuando un mismo lote de tareas presenta desviaciones sistemáticas, permite localizar rápidamente si fue una proporción incorrecta, un cambio en la estructura del prompt o un error de escritura en un campo.
Autoverificación de entrega y manejo de fallos
Tras recibir la imagen, autoverifique los siguientes puntos: si el formato cumple la proporción objetivo de aspect_ratio; si el sujeto está completo y sin recortes; si la zona de texto reservada está suficientemente limpia; si aparecen texto no deseado o elementos similares a marcas de agua; y si el formato de salida cumple los requisitos del destino. Si se usa como pancarta, previsualice también en el tamaño real de la página para confirmar que el título superpuesto no tapa el sujeto.
Si la tarea falla o el resultado se desvía, revise en orden: si prompt está vacío o excede los 1–5000 caracteres; si aspect_ratio está dentro de los valores de enumeración; si output_format usa solo png o jpeg; si se usó por error el obsoleto image_size; o si se enviaron campos no expuestos por esta línea. Una vez confirmados los parámetros correctos, simplifique el prompt y vuelva a intentarlo, en lugar de reenviar la misma entrada repetidamente. Si la desviación persiste varias veces, reduzca primero los elementos de la imagen al mínimo y vuelva a añadirlos uno por uno.
Recordatorio final: las ilustraciones del artículo son solo conceptuales, sirven para explicar el flujo de «la entrada pasa por el canal de tareas y se obtiene una imagen» y no son salidas reales de nano-banana. Se recomienda validar mediante llamadas propias todas las combinaciones de prompts y campos antes de pasar a producción. Consulte los detalles del modelo en /models/nano-banana.
Artículos relacionados
Ver todos los artículos →-
Guía de uso
Práctica de procesamiento de respuestas de Kimi K3: JSON completo, interrupciones de streaming y límites del reintento
-
Guía de uso
GLM 5.3 extracción estructurada en la práctica: cada campo JSON con respaldo en el texto original
Extraer campos con el modo de objeto JSON: frenar los errores antes de almacenarlos mediante valores ausentes, citas y validaciones de negocio
-
Guía de uso
Guía para crear canciones cortas con MiniMax Music 3: cómo separar la letra, las etiquetas de sección y el brief de arreglos
Diseñar una solicitud de canción corta reproducible basándose en las dos entradas obligatorias del contrato actual