Guide complet de la documentation de développement Nano Banana 2 : comparaison de 2 solutions entre l’API officielle et l’intégration APIYI

Note de l'auteur : Guide détaillé de la documentation de développement Nano Banana 2 (gemini-3.1-flash-image-preview), comparant les deux solutions d'accès via l'API officielle de Google et la plateforme APIYI, incluant des exemples de code complets, la configuration des paramètres et des stratégies d'économie.

Pour les développeurs souhaitant intégrer Nano Banana 2, deux documentations de développement sont actuellement disponibles : la documentation officielle de Google (ai.google.dev/gemini-api/docs/image-generation) et la documentation de la plateforme APIYI (docs.apiyi.com/api-capabilities/nano-banana-2-image).

Chaque solution a ses avantages : la documentation officielle est la plus exhaustive, tandis que celle d'APIYI propose l'intégration la plus simple avec des tarifs débutant à 0,03 $ par invocation. Cet article compare le contenu essentiel de ces deux documents pour vous aider à choisir la méthode d'accès la plus adaptée.

Valeur ajoutée : À la fin de cet article, vous maîtriserez l'ensemble des paramètres de l'API Nano Banana 2, les exemples de code pour les deux solutions, ainsi que le choix optimal selon vos scénarios d'utilisation.

Paramètres clés de la documentation de développement Nano Banana 2

Commençons par les configurations de paramètres les plus importantes. Ces paramètres sont universels, quelle que soit la solution d'accès choisie :

Les 14 rapports hauteur/largeur supportés par Nano Banana 2

🎯 Conseil de développement : Les ratios 1:4, 4:1, 1:8 et 8:1 sont des nouveautés exclusives à Nano Banana 2, non supportées par Nano Banana Pro. Si votre application nécessite des bannières horizontales ou des infographies verticales, vous devez utiliser gemini-3.1-flash-image-preview.

Solution d'intégration Nano Banana 2 A : API officielle de Google

Appel de base de l'API officielle

L'API officielle de Google utilise le SDK Google Gen AI, compatible avec Python, JavaScript, Go, Java et REST.

from google import genai
from google.genai import types

client = genai.Client()

# Génération de texte vers image de base
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Un chat roux se roulant dans les feuilles d'automne, tons chauds",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE']
    )
)

# Extraire l'image générée
for part in response.candidates[0].content.parts:
    if part.inline_data:
        with open("output.png", "wb") as f:
            f.write(part.inline_data.data)

from google import genai
from google.genai import types

client = genai.Client()

# Configuration complète : Résolution 2K + Format 16:9 + Mode réflexion (Thinking) High
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Couverture du rapport annuel d'une entreprise technologique, titre 'AI Vision 2026', tons bleu foncé, style minimaliste",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K"
        ),
        thinking_config=types.ThinkingConfig(
            thinking_level="High",
            include_thoughts=True
        )
    )
)

# Analyser la réponse (incluant le processus de réflexion)
for part in response.parts:
    if part.thought and part.text:
        print(f"[Processus de réflexion] {part.text}")
    elif part.inline_data:
        with open("report_cover.png", "wb") as f:
            f.write(part.inline_data.data)
        print("Image enregistrée")

Génération connectée avec Image Search via l'API officielle

C'est une capacité exclusive de Nano Banana 2 : effectuer une recherche d'images Google avant la génération pour obtenir des références visuelles réelles :

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Le dernier modèle Tesla Model Y 2026, argenté, garé dans une rue de la ville",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        tools=[
            types.Tool(google_search=types.GoogleSearch(
                search_types=types.SearchTypes(
                    web_search=types.WebSearch(),
                    image_search=types.ImageSearch()
                )
            ))
        ]
    )
)

🎯 Note : La génération connectée via Image Search a des exigences d'affichage — vous devez fournir un lien cliquable vers la page web de l'image source. Les tokens de réflexion (Thinking tokens) sont facturés, qu'ils renvoient ou non le processus de raisonnement.

Solution d'intégration Nano Banana 2 B : Plateforme APIYI

Avantages de l'intégration via APIYI

Appel au format compatible OpenAI via APIYI

Si vous avez déjà du code basé sur le SDK OpenAI, il suffit de modifier deux lignes pour intégrer Nano Banana 2 :

import openai

client = openai.OpenAI(
    api_key="VOTRE_CLE_APIYI",
    base_url="https://vip.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{"role": "user", "content": "Peinture de paysage à l'encre de Chine, composition épurée, montagnes lointaines dans la brume"}]
)

import requests
import base64

API_KEY = "VOTRE_CLE_APIYI"

response = requests.post(
    "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "contents": [{"parts": [{"text": "Affiche promotionnelle e-commerce, titre en gras 'Offre Spéciale Printemps', thème rouge"}]}],
        "generationConfig": {
            "responseModalities": ["IMAGE"],
            "imageConfig": {
                "aspectRatio": "9:16",
                "imageSize": "2K"
            }
        }
    },
    timeout=300
).json()

# Décoder et enregistrer l'image
img_data = response["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("poster.png", "wb") as f:
    f.write(base64.b64decode(img_data))
print("Image générée avec succès, coût environ 0,03 $")

Conseil : Inscrivez-vous sur APIYI (apiyi.com) pour obtenir votre clé API et commencer vos appels. La plateforme supporte à la fois le format compatible OpenAI et le format natif Google, permettant de basculer entre tous les modèles avec une seule clé.

Comparaison des prix des deux solutions Nano Banana 2

Comparaison des coûts mensuels Nano Banana 2 (1 000 images par jour)

Le tarif de 0,03 $/appel chez APIYI est non seulement 55 % moins cher que le prix standard officiel, mais il est même inférieur au demi-tarif du mode Batch officiel (0,034 $) — le tout avec un retour en temps réel, sans avoir à attendre 24 heures pour un traitement asynchrone.

🎯 Solution économique : En passant par APIYI (apiyi.com) pour vos appels Nano Banana 2, 1 000 images par jour ne vous coûtent que 30 $, soit un budget mensuel de 900 $. Inscrivez-vous pour recevoir un crédit de test gratuit ; une seule clé API suffit pour accéder à Nano Banana 2, Pro et aux autres modèles majeurs.

Guide de développement des fonctionnalités avancées de Nano Banana 2

Édition d'images par dialogue multi-tours

Nano Banana 2 permet de modifier continuellement la même image au cours d'une conversation :

# Édition multi-tours au format APIYI + OpenAI
messages = [
    {"role": "user", "content": "Génère un logo de marque au style minimaliste, dans les tons bleus"},
    # Après le retour du premier tour, on continue l'édition
    {"role": "assistant", "content": "[Résultat de la première génération]"},
    {"role": "user", "content": "Change la couleur en un dégradé de violet et ajoute le nom de l'entreprise 'TechFlow'"}
]

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=messages
)

Génération avec images de référence Nano Banana 2

Sélection du mode Thinking de Nano Banana 2

🎯 Conseil de dev : Les tokens de réflexion (Thinking tokens) sont facturés, que includeThoughts=true soit défini ou non. Si vous n'avez pas besoin de consulter le processus de raisonnement, laissez le paramètre sur false par défaut — cela n'affectera pas la qualité de la génération, cela empêchera simplement le retour du texte de raisonnement intermédiaire.

Référence de vitesse de génération pour Nano Banana 2

Conseil : Lors de l'invocation de Nano Banana 2, il est recommandé de régler timeout=300 (300 secondes) pour éviter les échecs dus aux fluctuations du réseau ou de la puissance de calcul de Google. Passer par le service proxy API de APIYI (apiyi.com) permet d'obtenir une connexion plus stable.

Questions Fréquentes

Résumé

Points clés de la documentation de développement de Nano Banana 2 :

1. Deux approches, chacune ses atouts : L'API officielle de Google est la plus complète (Image Search, Thinking, 14 images de référence), tandis qu'APIYI offre le prix le plus bas (0,03 $/génération) et l'intégration la plus simple.
2. APIYI à 0,03 $ = 45 % du prix officiel : Résultats en temps réel, encore moins cher que le tarif "Batch" officiel (0,034 $) et sans avoir à attendre 24 heures.
3. Paramètres universels : Les 4 niveaux de résolution, les 14 formats d'image et le mode Thinking sont disponibles dans les deux solutions.

Pour la plupart des développeurs, nous recommandons de passer par APIYI (apiyi.com) pour intégrer rapidement Nano Banana 2 : un prix de 0,03 $/génération, un format compatible OpenAI et des crédits gratuits offerts à l'inscription pour générer votre première image en moins de 5 minutes.

📚 Ressources de référence

1. Documentation officielle Google Gemini (Génération d'images) : Référence API complète pour Nano Banana 2

   • Lien : ai.google.dev/gemini-api/docs/image-generation
   • Description : Documentation officielle couvrant tous les paramètres, fonctions et fonctionnalités avancées.

2. Documentation APIYI pour Nano Banana 2 : Intégration rapide et exemples de code

   • Lien : docs.apiyi.com/api-capabilities/nano-banana-2-image
   • Description : Guide d'utilisation de la plateforme APIYI, incluant les tarifs et des exemples d'invocation.

3. Tarification officielle de l'API Gemini : Prix détaillés par résolution

   • Lien : ai.google.dev/gemini-api/docs/pricing#gemini-3.1-flash-image-preview
   • Description : Tarifs standards et tarifs Batch pour les résolutions 0.5K/1K/2K/4K.

4. Limites de débit de l'API Gemini : Quotas pour les modèles Preview

   • Lien : ai.google.dev/gemini-api/docs/rate-limits
   • Description : Comprendre les restrictions d'appel pour les modèles en version Preview.

Auteur : Équipe technique APIYI
Échanges techniques : N'hésitez pas à partager votre expérience de développement avec Nano Banana 2 dans les commentaires. Pour plus de ressources sur les modèles d'IA, visitez le centre de documentation APIYI sur docs.apiyi.com.