Flujos de trabajo de Nano Banana 2.1
Ejecutar Nano Banana 2.1 mediante la API de imágenes de Google Cloud
Un script local puede hacer una solicitud directa a Google Cloud. Mantén explícitos la autenticación, la selección del modelo, los ajustes de imagen y el manejo del resultado para que una respuesta de imagen fallida no se convierta silenciosamente en una exportación exitosa.
Qué crearás
Una solicitud directa con SDK y una lista de revisión para un proyecto de Google Cloud que controlas. Esto no da acceso a una API pública de LlamaGen.
Nano Banana 2.1 requiere un plan de pago de LlamaGen. Revisa el costo actual en créditos y las opciones de exportación antes de generar. La facturación directa de Google Cloud API se cobra por separado. Planes y créditos
El hero es un concepto de presentación generado por IA que muestra un resultado final en contexto. No es una fotografía de cliente, una captura de pantalla de una aplicación ni una prueba aparte del rendimiento del modelo.
Contenido revisado:
Revisar un ejemplo generado
El ejemplo de abajo es una salida directa del modelo, tomada de nuestro flujo de generación documentado. Revisa la imagen real, en vez de asumir que el modelo siguió cada instrucción.
Imágenes de referencia usadas en el flujo de generación
Son recursos de referencia ficticios y propios. Su inclusión no garantiza una identidad exacta ni el detalle del producto en el resultado.
Prepara tu propio acceso a Google Cloud
La documentación actual de Google llama a la plataforma Gemini Enterprise Agent Platform; muchos desarrolladores aún la buscan por su nombre anterior, Vertex AI. La muestra aquí sigue @google/genai 1.45.0, la versión instalada en nuestro flujo local de generación, usando vertexai: true. Las versiones más nuevas del SDK pueden cambiar el nombre de algunas opciones; sigue la documentación de la versión que tengas instalada.
Usa un proyecto con facturación, el servicio requerido habilitado y credenciales autorizadas para la solicitud. Mantén los archivos de cuenta de servicio y los tokens de acceso fuera del código fuente, del contenido de la página y de los prompts de imagen. Los cargos de Cloud API son independientes de cualquier plan de LlamaGen.
- Usa el ID exacto del modelo gemini-nano-banana-2.1.
- Usa la ubicación global documentada para este modelo.
- Sigue las instrucciones de Google para autenticación y configuración del proyecto en tu entorno.
Envía los ajustes que admite este endpoint
Para este modelo de Cloud, los tamaños de salida documentados son 1K, 2K y 4K. La página actual del modelo en Cloud indica un máximo de 14 imágenes de entrada por prompt y un límite de 7 MB por archivo para datos de imagen en línea; las entradas desde Cloud Storage tienen un límite diferente. Son límites específicos del endpoint, no una promesa de que cualquier combinación sea un buen brief creativo.
La documentación de Cloud indica explícitamente que seed, temperature, topP, topK y logprobs no son compatibles con Nano Banana 2.1. No copies esos ajustes desde un ejemplo de generación de texto ni describas un seed como un control de reproducibilidad para este modelo.
- Mantén el prompt y un pequeño conjunto de referencias relevantes fáciles de revisar.
- Usa el tipo MIME que coincida con los bytes reales de entrada.
- Registra el modelo, los ajustes de salida y los hashes de referencia junto con tu resultado.
Verifica que sí se haya devuelto una imagen
Inspecciona las partes de la respuesta para buscar datos de imagen en línea antes de escribir un archivo de salida. Una respuesta de texto, un resultado filtrado o una respuesta sin imagen deben tratarse como un resultado por revisar, no como una generación completada.
No reintentes a ciegas. Guarda metadatos no sensibles de la solicitud y el estado de la respuesta, revisa los límites documentados e investiga el motivo devuelto. Si vas a reintentar un fallo ambiguo, primero entiende el comportamiento actual de facturación de tu proveedor.
- No registres credenciales ni imágenes privadas completas de entrada.
- Conserva el tipo MIME de la imagen devuelta al elegir la extensión del archivo.
- Trata una imagen devuelta como una candidata que aún necesita revisión visual.
Separa las partes variables
Estas verificaciones describen la ruta directa de Google Cloud. No otorgan acceso a la API ni reemplazan la documentación actual de configuración de Google.
| Parte de la solicitud | Usar o revisar | Evita asumir |
|---|---|---|
| Autenticación | Tu propio proyecto y credenciales autorizados de Google Cloud | Que una suscripción de LlamaGen autentica una solicitud a Cloud API |
| Modelo y ubicación | gemini-nano-banana-2.1 en global | Que un alias de modelo parecido selecciona el mismo modelo |
| Ajustes de imagen | Relación de aspecto compatible, tamaño de salida y formato de referencia | Que seed o los parámetros de muestreo de un modelo de texto son compatibles |
| Respuesta | Bytes reales de la imagen, tipo MIME y un resultado que se pueda revisar | Que toda respuesta HTTP exitosa incluye una imagen lista para publicar |
Un flujo de trabajo práctico
De una solicitud pequeña a un archivo revisable
Empieza con una solicitud original de imagen sencilla. El ejemplo de abajo sigue la estructura directa de SDK que usamos en nuestro flujo local de generación; reemplaza el entorno del proyecto y autentícate con tu propia configuración aprobada.
Un prompt inicial para adaptar
Crea un mensajero ilustrado original que lleve una linterna en una calle lluviosa. Usa una silueta clara y una escena legible. No agregues texto ni logotipos.
Este brief es una receta adaptable, no el registro literal de la solicitud del resultado mostrado. No promete resultados idénticos ni una primera generación exitosa. El registro de generación conserva la solicitud original.
Probar el flujo
- Prepara las credenciales y tu proyecto fuera del archivo fuente.
- Ejecuta una solicitud pequeña con ajustes de imagen compatibles.
- Inspecciona las partes de imagen devueltas, guarda con el tipo MIME correcto y revisa el archivo real.
Qué revisar
- ¿Realmente se devolvió una parte de imagen?
- ¿El archivo guardado abre correctamente?
- ¿El visual coincide lo suficiente con el brief como para conservarlo?
Ejemplo directo de Google Cloud SDK
Esta es una solicitud directa a Google Cloud usando tu propio proyecto y credenciales. No es un endpoint público de la API de LlamaGen. No pegues claves privadas en un prompt ni en una página pública.
import { GoogleGenAI } from "@google/genai";
import { writeFile } from "node:fs/promises";
// @google/genai 1.45.0, matching the documented local workflow.
// Authenticate outside this file using Google Cloud credentials.
const ai = new GoogleGenAI({
vertexai: true,
project: process.env.GOOGLE_CLOUD_PROJECT,
location: "global",
httpOptions: { apiVersion: "v1" },
});
const response = await ai.models.generateContent({
model: "gemini-nano-banana-2.1",
contents: [{ role: "user", parts: [{
text: "Create an original illustrated courier carrying a lantern in a rainy street. No text or logos.",
}] }],
config: {
responseModalities: ["IMAGE"],
candidateCount: 1,
imageConfig: { aspectRatio: "3:2", imageSize: "2K" },
thinkingConfig: { thinkingLevel: "HIGH" },
},
});
const image = response.candidates?.[0]?.content?.parts?.find(
(part) => part.inlineData?.data,
)?.inlineData;
if (!image?.data) throw new Error("No image returned; inspect the response before retrying.");
const extensions = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp" };
const extension = extensions[image.mimeType];
if (!extension) throw new Error("Inspect the returned MIME type before saving.");
await writeFile(`nano-banana-2-1.${extension}`, Buffer.from(image.data, "base64"));Preguntas antes de empezar
¿Es esta una API pública de LlamaGen?
No. El código usa el SDK de Google para llamar directamente a Google Cloud con tu propio proyecto y credenciales. La página del modelo en LlamaGen es una entrada de producto aparte.
¿Puedo configurar seed o temperature?
La documentación actual del modelo en Cloud indica que seed, temperature, topP, topK y logprobs no son compatibles con Nano Banana 2.1. Revisa la documentación específica del endpoint antes de agregar parámetros a la solicitud.
¿Una respuesta sin imagen significa que debo reintentar de inmediato?
Primero revisa la respuesta y la guía actual del proveedor. Los filtros, límites y fallos transitorios pueden dar resultados distintos. Esta guía no promete que un reintento funcione ni que sea gratuito.