Google

Nano Banana 2 Lite

Nano-Banana-2-Lite

Modèle léger et efficace de la famille Google Image, axé sur une faible latence et un coût réduit, adapté au prototypage rapide et à la génération d'images à haut débit, et remplaçant sans effort le Nano Banana de première génération

Nano-Banana-2-Lite

Essayer Nano-Banana-2-Lite

Entrée

Créations

Voir toutes les créations

Sortie

image

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

Nano-Banana-2-Lite per image

Prix unitaire	$0.033

Présentation du positionnement

Nano-Banana-2-Lite est le modèle léger orienté efficacité de la gamme de génération d’images de Google ; il prend en charge à la fois la génération d’images à partir de texte et l’édition d’images à partir d’images de référence. Il privilégie la vitesse de réponse et le coût d’appel, et convient aux développeurs ayant besoin de produire des images en lot et d’itérer rapidement sur des premières versions ; il conserve des performances exploitables en suivi d’instructions et en cohérence des personnages, et peut couvrir des productions multi-formats, du croquis conceptuel à l’illustration marketing, avant un affinage selon les besoins.

Points clés

Génération d’images à partir de texte et édition d’images via une même interface — la même voie permet soit de générer directement une image à partir d’un prompt, soit de transmettre jusqu’à 10 images de référence pour l’édition et le remix, ce qui réduit les changements de flux de travail.
Positionnement efficacité pour les appels à haute fréquence — au sein de la gamme, il s’agit du niveau privilégiant vitesse et coût, adapté aux tâches sensibles au débit comme les assets en lot ou la génération d’images à partir de modèles.
Prise en charge de 14 ratios largeur-hauteur en sortie — des formats 1:1 et 16:9 aux proportions extrêmes comme 1:8 et 8:1, tous spécifiables directement, pour générer en une fois des visuels adaptés à plusieurs plateformes.
Itérations locales sur plusieurs tours — possibilité de modifier répétitivement des parties d’un résultat existant pour faire rapidement passer une première version à un état exploitable.

Description des capacités

Génération à partir de texte et édition à partir d’images de référence : transmettre uniquement un prompt déclenche la génération à partir de texte ; joindre des URL de 1 à 10 images de référence bascule vers l’édition ou le remix. La même interface couvre les deux besoins, ce qui facilite leur encapsulation unifiée dans un seul pipeline.

Sortie avec ratio largeur-hauteur contrôlable : aspect_ratio propose 14 valeurs et prend en charge la sélection automatique via auto ; les développeurs peuvent verrouiller directement le ratio selon l’emplacement de diffusion, ce qui évite les recadrages et adaptations secondaires ultérieurs.

Saisie de prompts longs : prompt peut atteindre 20 000 caractères, ce qui permet d’y intégrer des descriptions assez complètes du sujet, de la composition et du style, et convient à la construction en lot de requêtes de génération par assemblage de modèles.

Entrée de plusieurs images de référence : jusqu’à 10 images de référence JPEG, PNG ou WebP (30 Mo maximum par image), utilisables pour des tâches d’édition nécessitant un contexte multi-images, comme le transfert de style ou le mixage d’assets.

Cas d’usage

Production en lot de croquis conceptuels par des équipes créatives — générer en lot des croquis de propositions à partir de prompts courts, comme supports pour la revue interne et le tri des directions, afin de choisir l’orientation avant d’investir dans l’affinage.
Construction de pipelines de génération d’images à haut débit par les développeurs — générer en lot des visuels de produits ou de contenus à partir de prompts modèles, puis les stocker directement pour que les systèmes métier les appellent selon les besoins.
Visuels multi-emplacements pour le marketing et les réseaux sociaux — spécifier des ratios 1:1, 9:16, 16:9, etc. selon l’emplacement de diffusion, et générer en une fois des images finales en plusieurs tailles, ce qui réduit les reprises de recadrage en post-production.
Modifications locales en plusieurs tours sur des images existantes — téléverser une image de référence et décrire les changements dans le prompt, puis ajuster les détails locaux tour après tour pour produire des versions itératives livrables.
Contenus en série avec cohérence des personnages entre images — utiliser la même image de référence pour maintenir le personnage et l’identité visuelle, et produire en lot des ensembles d’illustrations ou des storyboards en conservant une apparence homogène de la série.

Limites et conseils de sélection

En tant que modèle léger privilégiant l’efficacité, la première version du rendu de texte pour des phrases longues ou des mises en page complexes peut nécessiter des ajustements manuels ; des instructions textuelles simples et explicites sont plus fiables. Pour les mises en page complexes et les détails de haute précision, il est conseillé de prévoir une étape de reprise. Les spécifications précises telles que la limite de résolution, la concurrence et les quotas ne sont pas connues à ce jour et doivent être vérifiées par vous-même avant l’intégration. Si la tâche exige une qualité d’image et une compréhension d’instructions complexes supérieures au débit, il convient de choisir un modèle plus avancé de la même gamme ; pour de simples croquis en lot et des itérations rapides, ce modèle est plus adapté.

Questions fréquentes

Voir toutes les questions →

À quelles tâches Nano Banana 2 Lite est-il principalement adapté ?

Une offre d'entrée de gamme à résolution fixe de 1K, adaptée aux grands lots d'esquisses, aux itérations rapides et à la retouche avec plusieurs images de référence en option.
Nano Banana 2 Lite prend-il en charge les images de référence ?

Prend en charge jusqu'à 10 images de référence facultatives ; sans téléversement, il peut être utilisé en génération d'images purement textuelle.
Quelles spécifications de sortie sont prises en charge ?

La page actuelle affiche 1K et auto, 1:1, 16:9, 9:16, 4:3, 3:4, 8:1, 1:8 ; les options finales dépendent des paramètres du Playground.
Comment Nano Banana 2 Lite est-il facturé ?

La facturation s'effectue selon le nombre d'images générées avec succès ; toute différence liée à la résolution ou au niveau de qualité s'affiche en temps réel dans le tarif indiqué sur la page.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : Nano-Banana-2-Lite

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour Nano-Banana-2-Lite et la route default — voir le tableau des paramètres ci-dessous.

promptstringRequisminLength 1maxLength 20000

Invite textuelle pour la génération d'images, sous forme de chaîne, jusqu'à 20000 caractères, décrivant le contenu visuel à générer ou à éditer.

image_urlsarrayOptionnelminItems 1maxItems 10

Tableau facultatif d'URL d'images de référence, dont les éléments sont des chaînes d'adresses d'images, utilisé pour l'édition d'images ou la composition mixte ; 10 images maximum, chacune au format JPEG/PNG/WebP et ne dépassant pas 30 Mo ; si non fourni, la génération se limite à du texte-vers-image pur.

Array [ string ]

aspect_ratiostringRequisDéfaut: "auto"

Rapport largeur-hauteur de l'image de sortie, sous forme de chaîne, par défaut auto, le modèle choisissant lui-même.

Options：auto1:12:33:23:44:34:55:4

Tout afficher (7)

9:1616:921:91:44:11:88:1

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "Nano-Banana-2-Lite",
  "input": {
    "prompt": "…",
    "aspect_ratio": "auto"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "Nano-Banana-2-Lite",
    input: {
      "prompt": "…",
      "aspect_ratio": "auto"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "Nano-Banana-2-Lite",
        "input": {
          "prompt": "…",
          "aspect_ratio": "auto"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}