API nano-banana-2 — Accès via une passerelle API IA
nano-banana-2 est le modèle d'image Gemini de Google, performant aussi bien en génération qu'en retouche d'images, et particulièrement doué pour la fusion multi-références (jusqu'à 6 images). Appelez-le via byesu — une passerelle API IA dotée d'une API image compatible OpenAI : les requêtes sont routées vers le modèle officiel, sans dégradation de qualité, facturées à l'image au tarif de $0.025 / image, avec des résolutions couvrant 1K / 2K / 4K. La même plateforme sert aussi les modèles texte Claude, GPT-5.6, Grok et Gemini, en facturation à l'usage, sans abonnement.
Cette page vous fournit un exemple d'intégration prêt à copier-coller. L'inscription à la console se fait sur byesu.com, et la documentation complète de l'API média est disponible sur docs.byesu.com/fr/media.
En une phrase : qu'est-ce que c'est et combien ça coûte
- Modèle :
nano-banana-2(Google Gemini pour l'image) — texte-vers-image et image-vers-image réunis, avec une fusion multi-références remarquable - Tarif : $0.025 / image, facturation à l'image ; les résolutions 1K / 2K / 4K sont toutes exprimées via le paramètre
size - Mode d'accès : API compatible OpenAI, Base URL
https://byesu.com/v1, jeton dans le groupemedia / media-gen
Le jeton doit être dans le bon groupe
Les jetons des modèles d'image doivent appartenir au groupe media / media-gen, sinon vous obtiendrez l'erreur « aucun canal disponible ». Lors de la création du jeton dans la console, sélectionnez-le simplement dans le menu déroulant « Groupe ». Voir Choisir un groupe pour plus de détails.
Comment l'appeler
Préparation : obtenir un jeton
- Ouvrez la console et connectez-vous → Jetons dans le menu de gauche → Ajouter un jeton
- Choisissez le groupe
media / media-gen, donnez-lui un nom, définissez un quota → validez - Copiez le jeton obtenu, de la forme
sk-xxxxxxxx
Texte-vers-image (curl)
La génération texte-vers-image passe par POST /v1/images/generations et renvoie de manière synchrone un PNG encodé en base64 :
curl https://byesu.com/v1/images/generations \
-H "Authorization: Bearer sk-votre-jeton" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2",
"prompt": "un golden retriever courant dans un champ de blé doré au crépuscule, cinématique, faible profondeur de champ",
"size": "2048x1152"
}'Réponse :
{ "data": [ { "b64_json": "<base64 string>" } ] }Texte-vers-image (Python)
import base64, requests
resp = requests.post(
"https://byesu.com/v1/images/generations",
headers={"Authorization": "Bearer sk-votre-jeton"},
json={
"model": "nano-banana-2",
"prompt": "rue cyberpunk sous la pluie nocturne, reflets de néons, photoréaliste 4K",
"size": "3840x2160", # côté long ≈3840 → 4K
},
).json()
b64 = resp["data"][0]["b64_json"]
open("out.png", "wb").write(base64.b64decode(b64))Image-vers-image / fusion multi-références (le point fort de nano-banana-2)
L'image-vers-image passe par POST /v1/images/edits, au format multipart/form-data. Les images de référence sont téléversées en tant que fichiers, et le champ image peut être répété pour envoyer plusieurs images (nano-banana-2 plafonne à 6 images, chacune ≤8MB) :
curl https://byesu.com/v1/images/edits \
-H "Authorization: Bearer sk-votre-jeton" \
-F model="nano-banana-2" \
-F prompt="fusionne les personnes de ces trois photos dans la même scène en bord de mer, avec un éclairage unifié" \
-F size="2048x2048" \
-F image=@person1.png \
-F image=@person2.png \
-F image=@scene.pngLe format de réponse est identique à celui du texte-vers-image (data[0].b64_json). En Python, envoyez plusieurs images avec files=[("image", open(p,"rb")) for p in paths].
Paramètres clés
| Paramètre | Endpoint | Requis | Description |
|---|---|---|---|
model | les deux | ✅ | Toujours renseigner nano-banana-2 ; la casse et le tiret doivent correspondre exactement |
prompt | les deux | ✅ | Le prompt texte ; détailler sujet + scène + style + éclairage donne de meilleurs résultats |
size | les deux | Largeur x hauteur en pixels, détermine à la fois le ratio et le niveau de résolution : côté long ≈1024 → 1K, ≈2048 → 2K, ≈3840 → 4K. Ex. "1024x1024" (1:1 · 1K), "2048x1152" (16:9 · 2K), "3840x2160" (16:9 · 4K). Sans valeur, le niveau de base 1:1 s'applique par défaut | |
image | edits uniquement | Champ de fichier pour les images de référence, répétable pour plusieurs images ; nano-banana-2 plafonne à 6 images, chacune ≤8MB |
La facturation ne compte que les « images », indépendamment du niveau de résolution : $0.025 / image. La console affiche le prix réellement facturé pour chaque appel.
Pourquoi passer par byesu pour accéder à nano-banana-2
- Modèle officiel, sans dégradation de qualité : les requêtes sont routées vers le service officiel — pas de rétro-ingénierie, de miroir ni de crack — la qualité de sortie est identique à celle du service officiel
- Tarification transparente à l'image :
nano-banana-2à $0.025 / image ; la console affiche le prix réellement facturé à côté du prix public officiel, et vous ne payez que ce que vous consommez - Remboursement automatique en cas d'échec : si une tâche média échoue, les frais sont automatiquement remboursés — vous ne payez pas pour des images ratées
- Adapté au multi-références : prise en charge native du téléversement multi-images via
/v1/images/edits, pour exploiter directement le point fort de nano-banana-2 : la fusion jusqu'à 6 images de référence - Une seule API pour tous les modèles : la même API compatible OpenAI appelle aussi les autres modèles d'image / vidéo / texte — changer de modèle revient à changer le champ
model - Facturation à l'usage, sans abonnement : rechargez en USDT, Alipay ou WeChat Pay et ne payez que les images que vous générez
Liens utiles
- Aperçu de l'API média (API image / vidéo)
- Modèles de génération d'images et paramètres
- Démarrage rapide : intégration en 3 étapes
- Choisir un groupe (à lire avant de créer un jeton)
- Inscription à la console / création d'un jeton
Questions fréquentes
Comment obtenir un accès à l'API nano-banana-2 ?
Inscrivez-vous sur la console byesu, créez un jeton dans le groupe media / media-gen, puis appelez nano-banana-2 via les endpoints compatibles OpenAI /v1/images/generations et /v1/images/edits avec la Base URL https://byesu.com/v1. byesu est une passerelle API IA — la même plateforme sert aussi Claude, GPT-5.6, Grok et Gemini, en facturation à l'usage, sans abonnement.
Combien coûte l'API nano-banana-2 par image ?
byesu facture nano-banana-2 à $0.025 par image, quel que soit le niveau de résolution (1K/2K/4K). Les générations échouées sont automatiquement remboursées, et la console affiche le prix réellement facturé pour chaque appel.
Comment réaliser une fusion multi-références avec nano-banana-2 ?
Appelez POST /v1/images/edits (format multipart) et placez chaque image de référence comme fichier dans le champ image, qui peut être répété pour téléverser plusieurs images. nano-banana-2 prend en charge jusqu'à 6 images de référence, chacune ≤8MB — idéal pour fusionner plusieurs personnes ou éléments dans une même scène.
Peut-on utiliser nano-banana-2 dans Claude Code ou une application cliente ?
nano-banana-2 est un modèle de génération d'images, appelé via les endpoints /v1/images/generations et /v1/images/edits plutôt que via l'API de chat ; il ne s'utilise donc pas comme modèle de conversation dans Claude Code. Vous pouvez l'appeler directement en curl/Python, ou le sélectionner dans l'atelier de génération de byesu. Les clients comme Claude Code, Codex et Cherry Studio se connectent, eux, aux modèles texte/code.
Quelles résolutions et quels ratios d'image nano-banana-2 prend-il en charge ?
Il prend en charge trois niveaux — 1K / 2K / 4K — exprimés via le paramètre size (largeur x hauteur en pixels) : un côté long d'environ 1024 correspond au 1K, environ 2048 au 2K et environ 3840 au 4K. Les ratios courants incluent 1:1, 16:9, 9:16, 4:3 et 3:4 — par exemple, 2048x1152 correspond à du 16:9 en 2K.
Que faire si l'appel de nano-banana-2 renvoie « aucun canal disponible » ?
C'est presque toujours un mauvais groupe de jeton. Les jetons des modèles d'image doivent appartenir au groupe media / media-gen. Créez un nouveau jeton dans ce groupe depuis la console et vérifiez que model vaut bien nano-banana-2 (casse et tiret identiques) : l'erreur disparaît.
