Google

Nano Banana Pro

nano-banana-pro

Modèle de génération et d'édition d'images axé sur la qualité, reposant sur le socle de raisonnement Gemini 3 Pro, plus performant pour la cohérence des personnages sur plusieurs images et le rendu du texte, avec une prise en charge de la sortie native en 2K et un agrandissement intelligent jusqu'en 4K

nano-banana-pro

Essayer nano-banana-pro

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

Spécifications	Prix unitaire
1K	$0.057
2K	$0.057
4K	$0.100

Présentation et positionnement

nano-banana-pro est un modèle de génération et d'édition d'images lancé par Google, qui prend en charge à la fois la génération à partir de texte et la génération à partir d'image. Il s'adresse aux tâches créatives privilégiant la qualité : il se montre plus stable sur la composition de l'image, la cohérence des personnages entre plusieurs images et le rendu du texte, et prend en charge une sortie de 1K à 4K ainsi que de nombreux formats d'image. Il convient aux designers, aux équipes de contenu e-commerce et de marque ayant besoin de productions visuelles sérielles, ainsi qu'aux développeurs qui intègrent des capacités de génération d'images dans leurs flux produits.

Points clés

Sortie jusqu'à 4K — la résolution de sortie est sélectionnable parmi trois paliers (1K, 2K, 4K), couvrant toute la chaîne, de l'aperçu rapide à l'image finale haute définition.
Jusqu'à 8 images de référence en entrée — en génération à partir d'image, plusieurs images de référence peuvent être fournies pour maintenir la cohérence des personnages et du style d'une image à l'autre, ce qui convient à la production de contenu sériel.
Composition et rendu du texte mieux maîtrisés — grâce à ses capacités de raisonnement, le modèle analyse la sémantique du prompt et les relations spatiales, ce qui rend les images plus exploitables pour les tâches de mise en page, les affiches et les couvertures comportant du texte.
Paramètres de format et de ratio ajustables — prise en charge de 11 ratios d'image et de deux formats de sortie (png, jpg), pour s'adapter directement aux spécifications des différents canaux.

Description des capacités

Génération à partir de texte et à partir d'image réunies : un même modèle peut générer une nouvelle image à partir d'un prompt texte ou éditer et transformer une image d'entrée selon un prompt, ce qui réduit les coûts liés au passage d'un modèle à l'autre.

Cohérence entre plusieurs références : jusqu'à 8 images de référence peuvent être fournies, permettant au modèle de maintenir personnages et style visuel au sein d'une série d'images, ce qui convient aux projets de contenu à produire par ensembles.

Contrôle de la résolution et du ratio : la sortie est sélectionnable en 1K, 2K ou 4K, avec prise en charge de 11 ratios allant de 1:1 à 21:9 ainsi que du choix automatique auto, pour produire directement des visuels conformes aux spécifications des emplacements de diffusion.

Raisonnement sémantique et de composition : avant la génération, le modèle analyse les relations entre objets et la disposition spatiale décrites dans le prompt, ce qui améliore la stabilité de la composition pour les descriptions complexes et réduit les tentatives répétées.

Cas d'usage

Équipes de contenu de marque et de réseaux sociaux : textes de campagnes — produire en série des affiches et des visuels sociaux au style unifié, en maintenant personnages et langage visuel sans dérive grâce à la cohérence entre plusieurs références.
E-commerce et design publicitaire : visuels produits et briefs créatifs — remplacer décors et styles tout en conservant le produit principal via la génération à partir d'image, pour obtenir des visuels directement utilisables en pages produits et emplacements publicitaires.
Préproduction jeu vidéo et audiovisuelle : character design et storyboards — verrouiller les traits d'un personnage à l'aide de plusieurs images de référence et générer des concept art et des storyboards cohérents d'un plan à l'autre, pour les revues et itérations internes.
Édition et design graphique : couvertures et affiches avec mise en page typographique — générer, grâce au rendu du texte et au contrôle de la composition, des premières versions de couvertures et d'affiches comportant un titre, en réduisant les reprises en post-production.

Limites et conseils de choix

Ce modèle est positionné sur la qualité : son processus de génération comporte une phase de raisonnement lourde, ce qui le rend plus lent que des modèles légers privilégiant le débit ; il ne convient pas aux scénarios exigeant une réponse en millisecondes ou des essais-erreurs rapides à grande échelle. La cohérence des personnages et le rendu du texte dépendent du prompt et de l'image concernée, sans garantie absolue ; pour les mises en page complexes, il est conseillé de valider d'abord sur un petit lot. Il ne prend en charge que la génération et l'édition d'images, pas les tâches de dialogue général ou de texte. Si l'objectif premier est une itération fréquente à faible coût, un modèle plus léger de la même famille peut être envisagé.

Questions fréquentes

Voir toutes les questions →

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

Générer des images commerciales très détaillées, ou effectuer une repeinture en combinant éventuellement des images de référence, avec une prise en charge de formats variés et une sortie jusqu'à 4K.
Nano Banana Pro prend-il en charge les images de référence ?

Prend en charge jusqu'à 8 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 auto, 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9 ; les options finales sont celles des paramètres du Playground.
Comment Nano Banana Pro est-il facturé ?

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

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

promptstringRequisminLength 1maxLength 20000

Invite textuelle décrivant l'image à générer ou à modifier, sous forme de chaîne, longueur maximale de 20 000 caractères.

resolutionstringOptionnelDéfaut: "1K"

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

Options：1K2K4K

image_inputarrayOptionnelmaxItems 8

Tableau facultatif d'URL d'images de référence, dont les éléments sont des liens d'images, 8 au maximum, formats image/jpeg, image/png et image/webp pris en charge, taille maximale de 30 Mo par fichier.

Array [ string ]

aspect_ratiostringOptionnelDéfaut: "auto"

Contrôle le rapport largeur-hauteur de l'image de sortie, sous forme de chaîne, valeur par défaut auto.

Options：auto1:116:99:163:44:33:22:3

Tout afficher (3)

5:44:521:9

output_formatstringOptionnelDéfaut: "png"

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

Options：pngjpg

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-pro",
  "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-pro",
    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-pro",
        "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"
    }
  }
}