Introduction
Nano Banana 2 Retouche d’image applique le Gemini 3.1 Flash Image de Google à des images que vous avez déjà. Il accepte une à quatorze sources, garde le format de la source ou recadre dans l’un des quatorze formats, et produit du 0.5k, 1k, 2k ou 4k.
Choisir le mode selon votre point de départ
| Ce que vous avez | Mode |
|---|---|
| un brief écrit | Nano Banana 2 Texte vers image |
| une image à modifier | Nano Banana 2 Retouche d’image |
Fonctionnalités et points forts
Jusqu’à quatorze références
Réunissez personnes, tenues, décors et produits de jusqu’à quatorze images, chacune décrite par son rôle dans le prompt. La voie économique en accepte jusqu’à dix ; au-delà, la retouche passe par la voie officielle, où chaque source ajoute un petit montant fixe : ne passez que celles dont la retouche a besoin.
Recadrer en retouchant
Le format auto garde la forme de la source ; l’un des quatorze formats recadre le résultat, comme dans notre exemple où une bannière 4:1 est devenue une scène de nuit en 16:9.
Rapide à toutes les tailles
Les mêmes niveaux qu’en texte vers image, des brouillons 0.5k aux versions finales 4k, avec un prix fixé par le niveau ; sur la voie officielle, chaque source ajoute un petit montant.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Jusqu’à 5 000 caractères. Décrivez le sujet, le décor, la lumière et l’objectif en phrases complètes ; les mots entre guillemets s’affichent comme du texte dans l’image. 1 caractères minimum · 5000 caractères maximum |
image_urls | Oui | De 1 à 14 images sources. Dites dans le prompt ce que chacune apporte : la personne, le décor, le produit. 1 éléments minimum · 14 éléments maximum |
aspect_ratio | Non | auto (par défaut) garde le format de l’image source ; sinon, choisissez l’un des quatorze formats, dont les bannières extrêmes 4:1, 1:4, 8:1 et 1:8. |
resolution | Non | 0.5k, 1k (par défaut), 2k ou 4k. Une image carrée fait 512, 1024, 2048 ou 4096 pixels de côté ; chaque niveau a son propre prix. |
enable_web_search | Non | Désactivé par défaut. Activé, le modèle vérifie des informations actuelles comme la météo, des dates ou des monuments avant de dessiner. Valeur par défaut: |
enable_image_search | Non | Désactivé par défaut. Activé, le modèle cherche des images de référence sur le web avant de dessiner, utile pour des lieux et des produits réels. Valeur par défaut: |
official_fallback | Non | Activé par défaut. Chaque édition passe d’abord par la route économique. Valeur par défaut: |
Tarification
Facturé à l’image selon le niveau de taille. Chaque retouche part d’abord sur la voie économique, au prix économique, sans frais par image source. Avec Official fallback (activé par défaut), une retouche que la voie économique refuse ou ne peut pas mener à bien, ou qui compte plus de 10 images sources, passe par la voie officielle au prix officiel, qui ajoute aussi de petits frais fixes pour chaque image source ; désactivé, vous ne payez que le prix économique. Les retouches en 0.5k ou avec recherche web ou recherche d’images passent par la voie officielle, et chaque recherche ajoute des frais. Le devis affiche le prix de départ et le montant maximal de la retouche. Sur la voie officielle, un refus qui arrive sous forme de courte réponse texte au lieu d’une image compte comme une génération terminée et est facturé au prix officiel ; les autres refus ne sont pas facturés.
| Spécification | Prix |
|---|---|
| $0.036 / image |
| $0.0384 / image (Avec Official fallback : jusqu’à $0.0536) |
| $0.0602 / image (Avec Official fallback : jusqu’à $0.0808) |
| $0.0902 / image (Avec Official fallback : jusqu’à $0.1208) |
Cas d’utilisation
Changer de lieu ou de moment
Déplacez une personne dans un nouveau lieu ou passez du jour à la nuit pour une campagne, en gardant le visage, la tenue et la pose.
Adapter des images finies à un autre format
Transformez une large bannière en version 16:9 ou 9:16 avec du contenu neuf sur les bords plutôt qu’un simple recadrage.
Mises en scène de produits
Disposez plusieurs photos produit dans une seule scène stylisée, en nommant chaque produit et sa place.
Guide de prompt et conseils pratiques
Lister ce qui doit rester
Après le changement, nommez le visage, les cheveux, la tenue et la pose à garder ; le modèle respecte une liste écrite.
Décrire le nouveau cadre en recadrant
Quand le format change, dites ce que l’espace ajouté doit contenir : plus de ciel, une autre table, le reste de la rue.
Réserver la recherche aux références réelles
N’activez la recherche d’images que si la retouche dépend d’un lieu ou d’un produit réel que le modèle doit voir.
Tester les retouches en 0.5k
Testez d’abord la consigne en 0.5k ; si le changement est juste, relancez la même requête en 2k ou 4k.
Adapter le niveau à la source
Une retouche ne peut pas ajouter un détail que la source n’a jamais eu ; 2k suffit généralement, sauf si la source est elle-même grande.
Démarrage rapide de l’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-2/edit",
"input": {
"aspect_ratio": "auto",
"enable_image_search": false,
"enable_web_search": false,
"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"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
