Processus complet d’intégration de l’API Nano Banana 2 : détails des étapes d’achat officielles et solutions alternatives recommandées

Note de l'auteur : Voici un guide complet pour parcourir le processus d'achat officiel de l'API Nano Banana 2 (via l'association de carte sur AI Studio et la configuration de Vertex AI). Nous analyserons les restrictions réseau pour les utilisateurs hors États-Unis et verrons comment APIYI peut servir de solution de secours pour garantir la continuité de vos services.

Dans notre précédent article, nous avons abordé l'intégration de Nano Banana Pro. Aujourd'hui, nous nous penchons sur son "frère", Nano Banana 2 (gemini-3.1-flash-image-preview). Bien qu'ils reposent tous deux sur le modèle d'image Gemini, le processus d'intégration de NB2 diffère légèrement : en mars 2026, AI Studio a modifié son système de facturation (passant au prépayé) et la configuration de Vertex AI présente également des spécificités. Cet article vous guidera pas à pas à travers le processus d'achat officiel, tout en vous présentant APIYI comme une alternative de secours — pour garantir à la fois une connexion directe aux services officiels et une continuité d'activité en cas de panne ou de dépassement de quota.

Valeur ajoutée : Maîtrisez le processus d'achat officiel, comprenez les coûts et les barrières à l'entrée, et préparez APIYI comme solution de secours pour assurer la continuité de vos opérations.

Informations essentielles sur l'accès officiel à l'API Nano Banana 2

Processus 1 : Accès via achat sur AI Studio (étapes complètes)

AI Studio est la plateforme privilégiée par la plupart des développeurs. Depuis mars 2026, le système de facturation a été modifié : on est passé d'une facturation liée à GCP à un système de prépaiement/post-paiement intégré à AI Studio.

Étape 1 : Créer un compte Google et se connecter à AI Studio

Note pour les utilisateurs en Chine : Vous avez besoin d'un VPN pour accéder à AI Studio. De plus, même avec un VPN, Google détecte la région d'enregistrement du compte — il est conseillé d'utiliser un compte Gmail américain.

Étape 2 : Générer une clé API

À ce stade, vous disposez d'une clé de niveau gratuit — Nano Banana 2 est pratiquement inutilisable avec ce niveau (RPD extrêmement bas, voire nul), vous devez passer au niveau payant.

Étape 3 : Associer un moyen de paiement et recharger

Depuis le 23 mars 2026, AI Studio utilise un nouveau système de facturation :

Étapes pour le prépaiement :

1. Accéder à la page Billing d'AI Studio
2. Cliquer sur "Buy Credits"
3. Choisir le montant (10 $ / 50 $ / 100 $ / personnalisé, jusqu'à 5 000 $)
4. Saisir les informations de la carte bancaire

Cartes acceptées : Visa, Mastercard, American Express, Discover, JCB

Obstacle pour les utilisateurs en Chine : Une carte bancaire internationale est nécessaire. Les cartes UnionPay domestiques ne sont pas acceptées. Vous devez disposer d'une carte Visa/Mastercard internationale ou passer par un service de carte bancaire virtuelle.

Étape 4 : Écrire le code pour l'invocation du modèle

from google import genai
from google.genai import types

# Initialisation du client avec votre clé API
client = genai.Client(api_key="VOTRE_CLE_AI_STUDIO")

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents=["Un golden retriever qui court sur la plage, soleil de l'après-midi"],
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(
            image_size="4K",
            aspect_ratio="16:9"
        ),
    )
)

# Sauvegarde de l'image générée
for part in response.parts:
    if image := part.as_image():
        image.save("output.png", format="PNG")

Étape 5 : Surveiller l'utilisation et les coûts

Le processus complet prend environ 30 à 45 minutes (incluant le temps de vérification de la carte bancaire).

Processus 2 : Achat et intégration via Vertex AI (Niveau entreprise)

Vertex AI est la solution idéale pour les entreprises ayant besoin d'un SLA, d'un contrôle des accès via IAM et de certifications de conformité.

Vue d'ensemble des étapes d'intégration à Vertex AI

Durée totale estimée : 2 à 3 heures.

Tarification de Vertex AI

Identique à celle d'AI Studio : 0,067 $ pour 2K, 0,151 $ pour 4K. Aucune remise.

La valeur ajoutée de Vertex AI réside dans : une garantie SLA de 99,9 %, une gestion fine des permissions IAM, une isolation réseau VPC et des quotas RPM personnalisables.

Restrictions réseau de Vertex AI

Tout comme pour AI Studio, il n'est pas possible de se connecter directement à aiplatform.googleapis.com depuis la Chine continentale ou la Russie. Les entreprises déploient généralement un serveur intermédiaire à Singapour ou au Japon pour servir de proxy.

Pourquoi adopter une stratégie de "double voie" avec APIYI ?

Certains développeurs nous demandent : puisque APIYI est plus simple et plus économique, pourquoi conserver une connexion directe aux API officielles ?

Scénarios où la connexion directe est nécessaire

Scénarios où APIYI assure la continuité (et ils sont nombreux)

Architecture recommandée : privilégiez APIYI (économique et stable), et gardez l'accès officiel comme solution de secours (si l'officiel tombe, c'est que la situation est critique).

Code d'intégration APIYI (une seule ligne de différence)

import openai

# Intégration APIYI : modifiez simplement la base_url
client = openai.OpenAI(
    api_key="YOUR_APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{
        "role": "user",
        "content": "Un golden retriever qui court sur la plage, soleil de l'après-midi"
    }]
)

import openai

# Principal : APIYI (économique + stable)
apiyi_client = openai.OpenAI(
    api_key="APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

# Secours : connexion directe officielle
from google import genai
official_client = genai.Client(api_key="GOOGLE_KEY")

def generate_image(prompt: str):
    """Double voie : priorité à APIYI, bascule vers l'officiel en cas d'échec"""
    try:
        # Premier choix : APIYI (0,045 $/image, stable)
        response = apiyi_client.chat.completions.create(
            model="gemini-3.1-flash-image-preview",
            messages=[{"role": "user", "content": prompt}]
        )
        return response, "apiyi"
    except Exception as e:
        print(f"Échec APIYI : {e}, bascule vers l'officiel...")
        try:
            # Secours : connexion directe (0,151 $/image)
            from google.genai import types
            response = official_client.models.generate_content(
                model="gemini-3.1-flash-image-preview",
                contents=[prompt],
                config=types.GenerateContentConfig(
                    response_modalities=["TEXT", "IMAGE"],
                ),
            )
            return response, "official"
        except Exception as e2:
            print(f"Échec officiel également : {e2} (si l'officiel est en panne, il n'y a plus rien à faire)")
            return None, "both_failed"

🎯 Conseil d'architecture : Utilisez APIYI au quotidien pour économiser et gagner en stabilité, tout en conservant le chemin de code officiel. Si APIYI tombe, basculez sur l'officiel ; si l'officiel tombe, basculez sur APIYI. Votre service reste ainsi ininterrompu (sauf en cas de panne majeure de l'infrastructure Google).

Différences d'intégration : Nano Banana 2 vs Nano Banana Pro

Si vous avez lu notre article précédent sur NB Pro, voici les différences clés pour l'intégration de NB2 :

FAQ

Résumé

Les points clés pour l'intégration de l'API Nano Banana 2 :

1. Les deux voies officielles nécessitent une carte bancaire et le plein tarif : AI Studio est rapide à prendre en main (30 min) mais nécessite une carte étrangère et coûte 0,151 $/image ; Vertex AI prend 2-3 heures mais offre un SLA. Les deux sont inaccessibles directement depuis la Chine/Russie.
2. APIYI est la solution optimale pour la sécurité et les économies : Intégration en 5 minutes, 0,045 $/4K (soit 30 % du prix), accès mondial direct, pas besoin de carte étrangère, facturation à l'usage et pas de frais en cas d'échec. Répond à la majorité des besoins professionnels.
3. L'architecture à double voie est la plus fiable : Utilisez APIYI au quotidien pour économiser et gardez le chemin de code officiel comme secours. Les deux se servent de sauvegarde mutuelle pour garantir une continuité de service (si l'officiel tombe, on ne peut rien y faire, mais une panne totale est extrêmement rare).

Nous recommandons d'accéder à l'API Nano Banana 2 via APIYI (apiyi.com) : 0,045 $/4K, accès mondial direct, prise en main en 5 minutes, et crédit de test offert à l'inscription.

📚 Références

1. Guide officiel du développeur Nano Banana 2 : Tutoriel d'intégration et d'utilisation de NB2 par Google

   • Lien : blog.google/innovation-and-ai/technology/developers-tools/build-with-nano-banana-2/
   • Description : Inclut les capacités du modèle, des exemples de code et les meilleures pratiques.

2. Documentation de facturation AI Studio : Nouveau système de facturation prépayée/postpayée

   • Lien : ai.google.dev/gemini-api/docs/billing
   • Description : Explications détaillées du nouveau système en vigueur depuis le 23/03/2026.

3. Limites de débit de l'API Gemini : Limites officielles et détails des niveaux

   • Lien : ai.google.dev/gemini-api/docs/rate-limits
   • Description : Quotas spécifiques pour les niveaux gratuit, Tier 1, Tier 2 et Tier 3.

4. Centre de documentation APIYI : Guide d'intégration Nano Banana 2 à 0,045 $ par image 4K

   • Lien : docs.apiyi.com
   • Description : Intégration en 5 minutes + connexion directe mondiale + facturation à l'usage + aucune facturation en cas d'échec.

Auteur : Équipe technique APIYI
Échanges techniques : N'hésitez pas à discuter dans la section commentaires. Pour plus d'informations, consultez le centre de documentation APIYI sur docs.apiyi.com.