Skip to content

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 groupe media / 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

  1. Ouvrez la console et connectez-vous → Jetons dans le menu de gauche → Ajouter un jeton
  2. Choisissez le groupe media / media-gen, donnez-lui un nom, définissez un quota → validez
  3. 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 :

bash
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 :

json
{ "data": [ { "b64_json": "<base64 string>" } ] }

Texte-vers-image (Python)

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) :

bash
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.png

Le 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ètreEndpointRequisDescription
modelles deuxToujours renseigner nano-banana-2 ; la casse et le tiret doivent correspondre exactement
promptles deuxLe prompt texte ; détailler sujet + scène + style + éclairage donne de meilleurs résultats
sizeles deuxLargeur 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
imageedits uniquementChamp 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

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.

Un problème ? Contactez le support ou rejoignez notre groupe.