Google

Nano Banana 2

nano-banana-2

Modèle d'image rapide de Google conçu pour la génération d'images à grande échelle, prenant en charge de 512 px jusqu'à la 4K native et divers formats d'image, générant à partir d'informations en temps réel issues de la recherche, idéal pour la création à haute fréquence

nano-banana-2

Essayer nano-banana-2

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 per image

Spécifications	Prix unitaire
1K	$0.036
2K	$0.057
4K	$0.086

Présentation

nano-banana-2 est un modèle de génération d'images lancé par Google, qui prend en charge à la fois la génération d'images à partir de texte et l'édition à partir d'images de référence. Il permet aux développeurs de générer en une seule fois une image au format et à la résolution choisis, à l'aide d'un prompt d'au plus 20000 caractères accompagné de 14 images de référence au maximum. Il convient aux équipes qui doivent produire des supports marketing en série, itérer rapidement sur des pistes créatives ou imposer une cohérence de style à partir d'images de référence ; il est accessible via l'interface unifiée de HiAPI.ai.

Points clés

Jusqu'à 14 images de référence par requête — le pipeline image-vers-image accepte jusqu'à 14 images de référence en une seule fois, pour contraindre un personnage, un style ou une mise en page à partir de plusieurs images et réduire les coûts d'assemblage liés aux générations par lots.
Trois niveaux de résolution en sortie directe — la résolution de sortie peut être choisie entre 1K, 2K et 4K, sans étape de suréchantillonnage supplémentaire pour les images haute résolution.
15 orientations de format — du carré 1:1 à l'ultra-large 8:1 en passant par le portrait 9:16, le format se spécifie directement dans les paramètres ou peut être laissé en auto pour une adaptation automatique.

Description des capacités

Génération à partir de texte et édition à partir d'images de référence : le prompt est l'entrée principale, avec la possibilité d'associer des images de référence pour une transformation ou une reprise de style ; une même interface couvre donc la génération à partir de zéro et la réécriture à partir de ressources existantes.

Contrôle paramétrique des spécifications de sortie : la résolution, le rapport largeur-hauteur et le format de sortie sont déclarés explicitement dans les paramètres de la requête ; le retour se fait en jpg ou png, ce qui permet d'alimenter directement le pipeline de ressources en aval.

Prise en charge de prompts longs : le champ prompt est limité à 20000 caractères, ce qui permet d'y intégrer une description d'image, des contraintes de style et des indications de composition assez complètes, sans avoir à couper drastiquement pour respecter la longueur.

Intégration via une interface unifiée : les résultats d'image sont obtenus via le mode d'appel unifié de HiAPI.ai, sans que les développeurs aient à maintenir une logique d'intégration amont distincte pour une capacité d'image isolée.

Cas d'usage

Production d'illustrations en série pour les équipes marketing — générer en série des visuels promotionnels aux dimensions de chaque plateforme à partir de prompts textuels, en produisant séparément du 1:1, du 16:9 et du 9:16, directement utilisables pour les réseaux sociaux et les supports publicitaires.
Exploration de la cohérence de style multi-images pour les designers — téléverser plusieurs images de référence pour contraindre un personnage ou un style visuel et produire une série d'images au style homogène, destinée aux comparaisons de pistes conceptuelles et aux itérations de propositions.
Génération en 4K pour les supports imprimés et les supports d'exposition — générer des images en résolution 4K et au format spécifié, pour les affiches, panneaux d'exposition et autres supports ayant des exigences précises de netteté et de rapport largeur-hauteur.

Limites et conseils de choix

Les limites de capacité sont celles des paramètres actuels : une seule image est générée par requête, sans options de nombre d'images par lot, de durée de génération ou de contrôle de type vidéo, et sans paramètres reproductibles comme la graine ; le prompt est obligatoire, aucune génération n'est possible sans lui. Les images de référence sont transmises par URL, dans la limite de 14. Si la tâche exige une édition stricte au pixel près, un contrôle aléatoire reproductible ou la production de plusieurs images par lot, il est conseillé de valider d'abord le résultat sur un petit échantillon avant de décider de l'intégrer au processus de production.

Questions fréquentes

Voir toutes les questions →

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

Il prend en charge des images de référence facultatives, une grande variété de formats et des résolutions plus élevées, et peut être utilisé pour la génération et le redessin d'images.
Nano Banana 2 prend-il en charge les images de référence ?

Prend en charge jusqu’à 14 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, 2K, 4K ainsi que 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, auto ; les options finales disponibles dépendent des paramètres du Playground.
Comment Nano Banana 2 est-il facturé ?

La facturation est basée sur le nombre d'images générées avec succès ; toute différence selon la résolution ou le niveau de qualité est indiquée dans le tarif en temps réel 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

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

promptstringRequismaxLength 20000

Texte d'invite décrivant l'image à générer, servant de base au contenu de la génération d'image.

resolutionstringOptionnelDéfaut: "1K"

Contrôle la résolution de l'image générée, sous forme de chaîne, par défaut 1K.

Options：1K2K4K

image_inputarrayOptionnelmaxItems 14

Tableau facultatif d'URL d'images d'entrée, utilisé pour la transformation d'image ou comme image de référence, jusqu'à 14 images prises en charge.

Array [ string ]

aspect_ratiostringOptionnelDéfaut: "auto"

Contrôle le rapport largeur-hauteur de l'image générée, sous forme de chaîne, par défaut auto.

Options：1:11:41:82:33:23:44:14:3

Tout afficher (7)

4:55:48:19:1616:921:9auto

output_formatstringOptionnelDéfaut: "png"

Contrôle le format de l'image de sortie, sous forme de chaîne, par défaut png.

Options：jpgpng

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",
  "input": {
    "prompt": "…",
    "resolution": "1K",
    "aspect_ratio": "auto",
    "output_format": "png"
  }
}'

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",
    input: {
      "prompt": "…",
      "resolution": "1K",
      "aspect_ratio": "auto",
      "output_format": "png"
    }
  }),
});
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",
        "input": {
          "prompt": "…",
          "resolution": "1K",
          "aspect_ratio": "auto",
          "output_format": "png"
        }
    },
)
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"
    }
  }
}