Introduction
Nano Banana Pro Retouche d’image applique le Gemini 3 Pro Image de Google à des images que vous avez déjà. Il accepte une à quatorze sources, planifie la retouche avant le rendu et renvoie du 1k, 2k ou 4k au format de la source ou dans l’un des dix formats.
Choisir le mode selon votre point de départ
| Ce que vous avez | Mode |
|---|---|
| un brief écrit | Nano Banana Pro Texte vers image |
| une image à modifier | Nano Banana Pro Retouche d’image |
Fonctionnalités et points forts
Retouches soignées à un seul changement
Une nouvelle lumière, un nouveau fond ou un texte ajouté pendant que les personnes et le reste de l’image restent tels quels, comme dans nos exemples aux bougies et de couverture. Le modèle planifie la retouche avant le rendu, ce qui garde stables les parties de l’image non concernées.
Du texte sur les photos
Titres, lignes de numéro et légendes sont posés sur l’image avec l’orthographe que vous citez, à l’endroit que vous indiquez.
Jusqu’à quatorze références
Réunissez personnes, produits et décors de nombreuses sources, chacune décrite par son rôle dans le prompt, en une seule requête de retouche.
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 dix formats de 21:9 à 9:16. Le format ne change pas le prix. |
resolution | Non | 1k (par défaut), 2k ou 4k. 1k et 2k coûtent le même prix ; 4k coûte plus et produit 4096 pixels sur le grand côté. |
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 8 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. Le devis affiche le prix de départ et le montant maximal de la retouche. Les requêtes refusées ne sont pas facturées.
| Spécification | Prix |
|---|---|
| $0.0668 / image (Avec Official fallback : jusqu’à $0.1072) |
| $0.0668 / image (Avec Official fallback : jusqu’à $0.1072) |
| $0.118 / image (Avec Official fallback : jusqu’à $0.192) |
Cas d’utilisation
Transformer des photos en couvertures et affiches
Ajoutez un titre, une date et une ligne de texte à une photo validée sans la retoucher.
Variantes d’ambiance et de lumière
Montrez la même scène aux bougies, à l’aube ou sous les néons pour un client qui choisit une direction.
Visuels de campagne localisés
Remplacez le texte d’une affiche finie par une ligne traduite pour chaque marché, tandis que la photo et sa lumière restent intactes.
Guide de prompt et conseils pratiques
Changer une chose à la fois
Les consignes à un seul changement gardent tout le reste stable ; enchaînez plusieurs retouches plutôt que de tout mettre dans un prompt.
Protéger les personnes
Après le changement, nommez la personne, la tenue et la pose qui doivent rester exactement identiques.
Prévoir du temps pour les retouches
Avec ce modèle, les retouches durent plus longtemps que le texte vers image : jusqu’à environ trois minutes dans nos tests en 2k sur la voie officielle, alors que nos retouches en 1k sur la voie économique se sont terminées en moins d’une minute.
Citer le texte avec sa position
Pour un texte ajouté, citez chaque ligne et indiquez sa place : en haut, en bas à gauche, à côté du logo.
Utiliser 2k par défaut
Avec ce modèle, 1k et 2k coûtent le même prix : retouchez en 2k sauf besoin d’un fichier plus léger.
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-pro/edit",
"input": {
"aspect_ratio": "auto",
"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.
