Guide d'utilisation
Guide de génération d'images par texte avec Nano Banana version de base : format, espaces réservés et usage des prompts
Utiliser les champs aspect_ratio et prompt de l'API de tâche pour générer des images à composition claire pour bannières et cartes sociales
Sur cette page
Positionnement et limites de cette ligne
nano-banana est sur HiAPI une ligne de génération d'images par texte (text-to-image), soumise sous forme de tâche asynchrone : les champs d'entrée du corps de requête sont regroupés sous l'objet input, et le résultat est récupéré comme une tâche après soumission. Elle convient aux scénarios nécessitant de la production d'images en lot, par exemple bannières marketing, cartes sociales, ébauches d'illustration d'articles. Cet article ne traite que de la version de base et n'aborde pas les autres modèles de la même série.
Peu de champs sont disponibles, il convient donc de clarifier d'abord le contrat : prompt est une chaîne obligatoire de 1 à 5000 caractères ; aspect_ratio est facultatif, par défaut auto, avec les valeurs énumérées auto, 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9 ; output_format accepte png ou jpeg, par défaut png. L'ancien champ image_size est abandonné ; pour spécifier le format cible, utilisez aspect_ratio.
Il faut préciser que cette ligne n'expose pas les champs resolution, quality, width, height, seed ni le téléversement d'images de référence. N'ajoutez pas ces clés dans input selon les habitudes d'autres modèles d'image, et ne présumez pas qu'elles seront silencieusement ignorées. De même, aspect_ratio sert à spécifier le rapport de format cible et ne garantit pas une taille de pixels fixe ; le format et les pixels réels sont à vérifier sur l'image retournée avant livraison.

Contrat des champs et fragment input minimal
Voici un fragment input ne contenant que les champs ci-dessus, destiné à illustrer la hiérarchie des champs. Ce n'est pas une requête HTTP complète : l'endpoint, les en-têtes d'authentification et le mode d'interrogation de la tâche ne sont pas fournis ; référez-vous à la documentation de l'API HiAPI.
{
"input": {
"prompt": "Illustration géométrique plate en composition horizontale, fond sable chaud, un tiers droit en blocs colorés en escalier, espace vide à gauche, aucun texte dans l'image.",
"aspect_ratio": "16:9",
"output_format": "png"
}
}
La rédaction du prompt influence le degré de contrôle de l'image. Un ordre pratique est : d'abord le sujet et la scène, puis la composition et la position du sujet, ensuite les zones d'espace vide, et enfin les couleurs, la lumière et le style. Si l'image ne doit pas contenir de texte, écrire explicitement « aucun texte, lettre ni chiffre dans l'image » est plus simple que de retoucher après coup. Inutile d'atteindre 5000 caractères ; il suffit d'énoncer clairement les contraintes clés ; un empilement trop long dilue les points importants.
Le choix d'output_format dépend de la chaîne de livraison : png convient à une sauvegarde sans perte et à l'édition ultérieure, jpeg à une livraison avec compression avec perte. La valeur par défaut est png ; si l'aval est sensible au poids, pensez à passer explicitement à jpeg. À noter : pouvoir choisir png ne signifie pas que le modèle génère un canal alpha transparent ; cette ligne ne déclare ni ne fournit de champ pour le fond transparent et ne garantit pas de détourage ni de sortie transparente.
Format et espaces réservés : définir la mise en page avant le prompt
L'espace réservé n'est pas « du vide », mais un emplacement prévu pour le titre, le bouton ou le coin. Les stratégies diffèrent selon le format ; lors de la rédaction du prompt, décrivez l'espace réservé comme partie intégrante de la composition.
- Bannière 16:9 : courante pour les têtes de site et les couvertures d'articles. Il est conseillé de décaler le sujet vers le tiers droit ou gauche et de laisser de l'autre côté une zone continue à faible information, pour éviter que le sujet ne recouvre le titre. Dans le prompt, on peut écrire « conserver à gauche environ un tiers de largeur en zone peu contrastée ».
- Carte sociale 1:1 : sujet centré, avec un espace de respiration en haut et en bas ; les éléments des bords ne doivent pas toucher le bord, pour éviter d'être coupés lors du recadrage dans le fil d'actualité.
- Vertical 9:16 : laisser une bande en haut et en bas pour le titre et la signature ; placer le sujet au milieu, pour éviter le chevauchement avec les zones de texte des extrémités.
- 4:5 et 3:4 : proportions courantes proches de l'impression et du fil d'actualité ; l'espace réservé peut être réduit, mais il est conseillé de conserver une marge de sécurité sur les quatre côtés.
- Ultra-large 21:9 : l'espace horizontal est abondant, idéal pour rythmer plusieurs éléments, mais les extrémités sont facilement recadrées ; ne collez pas les sujets importants aux bords.
- auto : le serveur décide du rapport, adapté à l'exploration initiale ; dès la production en lot, il est conseillé de spécifier explicitement le rapport pour réduire les reprises de mise en page.
Il faut le réaffirmer : le rapport n'est pas le pixel. aspect_ratio définit le rapport de format cible ; 16:9 ne signifie pas une taille de pixels fixe (par exemple 1920×1080). Après réception de l'image, vérifiez que le format réel correspond à l'attendu ; si l'aval impose des dimensions strictes, redimensionnez ou recadrez vous-même, et prévoyez la marge de sécurité dès l'étape du prompt.
Deux exemples de prompts directement réutilisables
Les deux textes suivants sont des formulations à vérifier, pas des conclusions mesurées. Il est conseillé de les appeler une fois chacun pour observer la position du sujet et l'espace réservé, puis d'ajuster selon le projet.
Espace réservé de bannière (16:9) :
« Illustration géométrique plate en composition horizontale, fond sable chaud. Dans le tiers droit, placer un ensemble de blocs en escalier composé de carrés terracotta, ocre et brun foncé, descendant progressivement de gauche à droite, avec des bords nets ; les deux tiers gauches restent une zone peu contrastée, sans détails, en espace vide, avec seulement de très légères bandes horizontales comme transition. Tonalité sobre, sans bruit de dégradé, sans texte, lettre, chiffre ni logo, composition équilibrée, adaptée à une image d'en-tête d'article. »
Carte sociale (1:1) :
« Illustration minimaliste en composition carrée, fond beige clair. Au centre, placer un signe abstrait formé de trois arcs superposés, en vert encre foncé et ocre, d'épaisseur de trait uniforme ; autour du signe, conserver un espace vide homogène, légèrement plus grand en haut et en bas qu'à gauche et à droite, pour faciliter l'ajout ultérieur d'un titre. Fond pur, sans texture, sans ombre, sans texte, lettre, chiffre ni logo, ambiance calme et sobre. »
Les deux prompts formulent l'« espace vide » comme une description spatiale exécutable, et non par une simple phrase « plus d'espace vide ». Si le sujet généré touche encore le bord, ajustez d'abord les indicateurs de position et les proportions dans la description plutôt que d'empiler les adjectifs.
Itération progressive : ne modifier qu'une variable à la fois
L'erreur la plus fréquente en production d'images en lot est de modifier en une fois le prompt, le rapport et le format, puis de ne pas pouvoir identifier ce qui a causé le changement. Une approche plus sûre est de converger par étapes.
- Étape 1 : fixer aspect_ratio et output_format, utiliser un prompt court pour confirmer que le sujet est correctement compris.
- Étape 2 : ajouter la description de composition : position du sujet, proportion de l'image occupée, zones d'espace vide.
- Étape 3 : compléter couleurs, lumière et style, en observant si l'espace vide est comprimé.
- Étape 4 : organiser la description stabilisée en modèle, en ne remplaçant que le sujet et la palette lors des lots, sans modifier les phrases de structure.
Après chaque appel, consignez le prompt, aspect_ratio, output_format et les différences du résultat. La consignation est elle-même un atout : en cas de dérive systématique sur un même lot, on peut rapidement identifier si c'est un mauvais choix de rapport, un changement de structure du prompt ou une faute d'orthographe dans un champ.
Auto-contrôle de livraison et gestion des échecs
Après réception de l'image, contrôlez les points suivants : le format correspond-il au rapport cible d'aspect_ratio ; le sujet est-il complet et non recadré ; la zone de texte réservée est-elle suffisamment propre ; des éléments de texte ou de type filigrane non désirés apparaissent-ils ; le format de sortie répond-il aux exigences de l'aval. Pour une bannière, prévisualisez également à la taille réelle de la page pour confirmer que le titre superposé ne recouvre pas le sujet.
En cas d'échec de la tâche ou d'écart du résultat, vérifiez dans l'ordre : le prompt est-il vide ou hors de la plage 1–5000 caractères ; aspect_ratio est-il dans les valeurs énumérées ; output_format n'utilise-t-il que png ou jpeg ; l'ancien image_size a-t-il été utilisé par erreur ; des champs non exposés par cette ligne ont-ils été transmis. Après confirmation des paramètres, simplifiez le prompt et réessayez, plutôt que de soumettre plusieurs fois la même entrée. En cas d'écarts répétés, réduisez d'abord les éléments de l'image au minimum, puis rajoutez-les un par un.
Dernier rappel : les illustrations de cet article ne sont que des schémas conceptuels, destinés à illustrer le processus « l'entrée passe par le canal de tâche pour produire une image », et ne sont pas des sorties réelles de nano-banana. Toutes les combinaisons de prompts et de champs doivent d'abord être vérifiées par vos propres appels avant d'entrer en production. Détails du modèle : /models/nano-banana.
Articles similaires
Voir tous les articles →-
Guide d'utilisation
Gestion des réponses Kimi K3 en pratique : JSON complet, interruption de flux et limites de la logique de retry
-
Guide d'utilisation
GLM 5.3 en pratique pour l'extraction structurée : chaque champ JSON adossé à un extrait du texte source
Extraction de champs en mode objet JSON : valeurs manquantes, citations et validation métier pour bloquer les erreurs avant l'insertion en base
-
Guide d'utilisation
Guide de production de chansons courtes avec MiniMax Music 3 : comment séparer paroles, balises de section et brief d'arrangement
Concevoir une requête de chanson courte reproductible sur la base des deux entrées obligatoires du contrat actuel