Workflows Nano Banana 2.1
Exécuter Nano Banana 2.1 via l’API image Google Cloud
Un script local peut envoyer une requête directe à Google Cloud. Gardez explicites l’authentification, la sélection du modèle, les paramètres d’image et le traitement du résultat afin qu’une réponse image échouée ne se transforme pas silencieusement en export réussi.
Ce que vous allez créer
Une requête SDK directe et une checklist de vérification pour un projet Google Cloud que vous contrôlez. Il ne s’agit pas d’un accès à une API publique de LlamaGen.
Nano Banana 2.1 nécessite un abonnement LlamaGen payant. Vérifiez le coût en crédits et les options d’export avant de générer. La facturation directe de l’API Google Cloud est distincte. Abonnements et crédits
Le visuel principal est un concept de présentation généré par IA montrant un résultat final dans son contexte. Ce n’est ni une photo client, ni une capture d’écran d’application, ni un test séparé des performances du modèle.
Contenu vérifié:
Examiner un exemple généré
L’exemple ci-dessous est une sortie directe du modèle issue de notre workflow de génération documenté. Examinez l’image réelle, au lieu de supposer que le modèle a suivi chaque instruction.
Images de référence utilisées dans le workflow de génération
Il s’agit de ressources de référence fictives et détenues. Leur inclusion ne garantit pas une identité exacte ni le détail produit dans le résultat.
Préparez votre propre accès Google Cloud
La documentation actuelle de Google nomme la plateforme Gemini Enterprise Agent Platform ; beaucoup de développeurs recherchent encore son ancien nom, Vertex AI. L’exemple ici suit @google/genai 1.45.0, la version installée dans notre workflow de génération local, avec vertexai: true. Les versions plus récentes du SDK peuvent renommer certaines options ; suivez la documentation de votre version installée.
Utilisez un projet avec la facturation activée, le service requis activé et des identifiants autorisés pour la requête. Conservez les fichiers de compte de service et les jetons d’accès en dehors du code source, du contenu de la page et des prompts d’image. Les frais de l’API Cloud sont distincts de tout abonnement LlamaGen.
- Utilisez l’ID exact de modèle gemini-nano-banana-2.1.
- Utilisez la région globale documentée pour ce modèle.
- Suivez les instructions de Google pour l’authentification et la configuration du projet dans votre environnement.
Envoyez les paramètres pris en charge par ce point de terminaison
Pour ce modèle Cloud, les tailles de sortie documentées sont 1K, 2K et 4K. La page actuelle du modèle Cloud indique un maximum de 14 images d’entrée par prompt et une limite de 7 Mo par fichier pour les données d’image intégrées ; les entrées Cloud Storage ont une autre limite. Il s’agit de limites propres au point de terminaison, pas d’une promesse que chaque combinaison constitue un bon brief créatif.
La documentation Cloud indique explicitement que seed, temperature, topP, topK et logprobs ne sont pas pris en charge pour Nano Banana 2.1. Ne copiez pas ces réglages depuis un exemple de génération de texte et ne décrivez pas un seed comme un contrôle de reproductibilité pour ce modèle.
- Gardez le prompt et un petit ensemble de références pertinentes faciles à examiner.
- Utilisez le type MIME correspondant aux octets d’entrée réels.
- Consignez le modèle, les paramètres de sortie et les empreintes des références avec votre propre résultat.
Vérifiez qu’une image a bien été renvoyée
Examinez les parties de la réponse à la recherche de données d’image intégrées avant d’écrire un fichier de sortie. Une réponse textuelle, un résultat filtré ou une réponse sans image doivent être traités comme un résultat à examiner, et non comme une génération terminée.
Ne relancez pas à l’aveugle. Enregistrez les métadonnées de requête non sensibles et le statut de la réponse, vérifiez les limites documentées et analysez la raison renvoyée. Si vous relancez un échec ambigu, comprenez d’abord le fonctionnement actuel de la facturation de votre fournisseur.
- N’enregistrez pas les identifiants ni les images d’entrée privées en entier.
- Conservez le type MIME de l’image renvoyée lors du choix de l’extension de fichier.
- Considérez une image renvoyée comme un candidat qui nécessite encore une vérification visuelle.
Séparez les éléments variables
Ces vérifications décrivent le parcours direct Google Cloud. Elles n’accordent pas d’accès API et ne remplacent pas la documentation actuelle de Google sur la configuration.
| Élément de la requête | Utiliser ou vérifier | À ne pas supposer |
|---|---|---|
| Authentification | Votre propre projet Google Cloud autorisé et vos identifiants | Qu’un abonnement LlamaGen authentifie une requête vers l’API Cloud |
| Modèle et région | gemini-nano-banana-2.1 en global | Qu’un alias de modèle similaire sélectionne le même modèle |
| Paramètres d’image | Ratio pris en charge, taille de sortie et format de référence | Que seed ou les paramètres d’échantillonnage d’un modèle texte sont pris en charge |
| Réponse | Octets d’image réels, type MIME et résultat vérifiable | Que chaque réponse HTTP réussie inclut une image publiable |
Un workflow pratique
D’une petite requête à un fichier vérifiable
Commencez par une requête d’image originale simple. L’exemple ci-dessous suit la structure SDK directe utilisée par notre workflow de génération local ; remplacez l’environnement du projet et authentifiez-vous via votre propre configuration approuvée.
Un prompt de départ à adapter
Créez un coursier illustré original portant une lanterne dans une rue sous la pluie. Utilisez une silhouette claire et une scène lisible. N’ajoutez ni texte ni logos.
Ce brief est une recette adaptable, pas le journal exact de la demande ayant produit le visuel affiché. Il ne promet ni un résultat identique ni une première génération réussie. L’historique de génération conserve la demande d’origine.
Essayer le workflow
- Préparez les identifiants et le projet en dehors du fichier source.
- Lancez une petite requête avec des paramètres d’image pris en charge.
- Examinez les parties d’image renvoyées, enregistrez avec le bon type MIME et vérifiez le fichier réel.
Ce qu’il faut vérifier
- Une partie image a-t-elle bien été renvoyée ?
- Le fichier enregistré s’ouvre-t-il correctement ?
- Le visuel correspond-il suffisamment au brief pour être conservé ?
Exemple direct avec le SDK Google Cloud
Il s’agit d’une requête directe vers Google Cloud utilisant votre propre projet et vos identifiants. Ce n’est pas un point de terminaison API public de LlamaGen. N’insérez pas de clés privées dans un prompt ou sur une page publique.
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"));Questions avant de commencer
Est-ce une API publique LlamaGen ?
Non. Le code utilise le SDK de Google pour appeler Google Cloud directement avec votre propre projet et vos identifiants. La page du modèle LlamaGen est une fiche produit distincte.
Puis-je définir un seed ou une temperature ?
La documentation actuelle du modèle Cloud indique que seed, temperature, topP, topK et logprobs ne sont pas pris en charge pour Nano Banana 2.1. Consultez la documentation du point de terminaison concerné avant d’ajouter des paramètres de requête.
Une réponse sans image signifie-t-elle qu’il faut relancer immédiatement ?
Examinez d’abord la réponse et les consignes actuelles du fournisseur. Les filtres, les limites et les erreurs transitoires peuvent produire des résultats différents. Ce guide ne promet pas qu’une nouvelle tentative réussira ni qu’elle sera gratuite.
Poursuivre le workflow
- Nano Banana 2.1 vs Pro : choisissez selon la tâche à réaliser
- Retouchez une image avec Nano Banana 2.1 sans perdre le brief
- Créez une fiche de référence de personnage réellement vérifiable
- Transformez une courte scène en storyboard lisible avec Nano Banana 2.1
- Placer un produit dans une scène lifestyle sans perdre ses détails