Flujos de trabajo de Nano Banana 2.1
Ejecuta 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é vas a crear
Una solicitud directa con SDK y una lista de verificación para revisar un proyecto de Google Cloud que tú controlas. Esto no es 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 es independiente. Planes y créditos
El hero es un concepto de presentación generado con IA que muestra un resultado terminado en contexto. No es una foto de cliente, una captura de pantalla de la app ni una prueba separada del desempeño del modelo.
Contenido revisado:
Revisar un ejemplo generado
El ejemplo de abajo es un resultado directo del modelo, generado con nuestro flujo de trabajo documentado. Revisa la imagen real, en lugar de asumir que el modelo siguió cada instrucción.
Imágenes de referencia usadas en el flujo de generación
Estos son activos de referencia ficticios y de propiedad propia. 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 vigente de Google llama a la plataforma Gemini Enterprise Agent Platform; muchos desarrolladores aún la buscan por su nombre anterior, Vertex AI. El ejemplo aquí sigue @google/genai 1.45.0, la versión instalada en nuestro flujo de generación local, usando vertexai: true. Las versiones más nuevas del SDK pueden cambiar el nombre de las 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 service account 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 la API de Cloud 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 autenticación y configuración de proyecto de Google para tu entorno.
Envía solo 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 distinto. Estos 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 de un ejemplo de generación de texto ni describas un seed como 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
Revisa las partes de la respuesta para detectar 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 reintentas una falla ambigua, 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 un candidato que todavía necesita revisión visual.
Separa las piezas móviles
Estas verificaciones describen la ruta directa de Google Cloud. No otorgan acceso a la API ni sustituyen la documentación actual de configuración de Google.
| Parte de la solicitud | Usa o revisa | Evita asumir |
|---|---|---|
| Autenticación | Tu propio proyecto y credenciales autorizados de Google Cloud | Que una suscripción de LlamaGen autentica una solicitud a la API de Cloud |
| Modelo y ubicación | gemini-nano-banana-2.1 en global | Que un alias similar del modelo 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 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 sola solicitud sencilla de imagen original. El ejemplo de abajo sigue la estructura directa de SDK usada por nuestro flujo de generación local; sustituye el entorno del proyecto y autentícate con tu propia configuración aprobada.
Un prompt inicial para adaptar
Crea un repartidor ilustrado original que cargue 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 textual de la solicitud del resultado mostrado. No promete resultados idénticos ni que la primera generación sea exitosa. El registro de generación conserva la solicitud original.
Probar el flujo de trabajo
- Prepara las credenciales y tu proyecto fuera del archivo fuente.
- Haz una solicitud pequeña con ajustes de imagen compatibles.
- Revisa las partes de imagen devueltas, guarda con el tipo MIME correcto y revisa el archivo real.
Qué revisar
- ¿Sí regresó 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
¿Esta es una API pública de LlamaGen?
No. El código usa el SDK de Google para llamar a Google Cloud directamente con tu propio proyecto y credenciales. La página del modelo de LlamaGen es una entrada de producto separada.
¿Puedo configurar un 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 del endpoint específico antes de agregar parámetros a la solicitud.
¿Una respuesta sin imagen significa que debo reintentar de inmediato?
Revisa primero la respuesta y la guía actual del proveedor. Los filtros, límites y fallas transitorias pueden dar resultados distintos. Esta guía no promete que un reintento funcione ni que sea gratis.
Continuar tu flujo de trabajo
- Nano Banana 2.1 vs Pro: elige según la tarea que tienes enfrente
- Edita una imagen con Nano Banana 2.1 sin perder el brief
- Crea una hoja de referencia de personaje que sí puedas revisar
- Convierte una escena breve en un storyboard legible con Nano Banana 2.1
- Coloca un producto en una escena lifestyle sin perder sus detalles