Clé API Gemini : AI Studio, quotas et accès depuis la Chine (2026)

Gemini est la famille de modèles multimodaux de Google : elle accepte du texte, des images, de l'audio et de la vidéo. Lors de la première utilisation de l'API Gemini, trois points bloquent souvent les développeurs : où créer la clé, comment fonctionne le quota gratuit et comment appeler le modèle de manière stable depuis la Chine.

Cet article, écrit du point de vue de ZSQH AI Gateway, explique l'obtention, la configuration, l'appel et les erreurs courantes d'une clé API Gemini.

Les versions citées sont celles couramment observées en octobre 2026. L'interface et les quotas de Google AI Studio évoluent ; la console officielle fait foi.

1. À quoi sert l'API Gemini

Usages courants :

résumé, traduction et réécriture de documents longs ;
compréhension d'images et de vidéos, modération de contenu ;
questions-réponses multimodales, OCR, extraction de tableaux ;
génération et explication de code ;
nœuds de raisonnement dans un workflow d'agent.

Les modèles Gemini se répartissent notamment entre les gammes Pro et Flash. Pro est plus puissant, Flash plus rapide et moins coûteux. Les noms de modèles, la longueur de contexte et les tarifs applicables figurent sur la page Tarifs des modèles.

2. Deux façons d'obtenir une clé API Gemini

Option A : clé officielle via Google AI Studio

Ouvrez Google AI Studio.
Connectez-vous avec un compte Google.
Accédez à la page des clés API et créez une clé.
Copiez la clé et conservez-la dans un gestionnaire de mots de passe.
Associez un compte de facturation au projet si vous avez besoin d'un quota plus élevé.

Cette option convient aux utilisateurs ayant un accès stable à Google, besoin d'une connexion directe et un volume modéré.

Option B : clé via ZSQH AI Gateway

Ouvrez ZSQH AI Gateway, inscrivez-vous et connectez-vous.
Accédez à la page « Clés API » et créez une clé.
Définissez un plafond de quota et une date d'expiration.
Rechargez votre portefeuille.
Copiez la clé.

Cette option convient aux équipes dont l'accès est instable, qui veulent une facturation unifiée ou qui utilisent plusieurs fournisseurs de modèles.

3. Quelle URL de base utiliser

API Gemini officielle

L'URL de base de l'interface native Gemini est :

https://generativelanguage.googleapis.com

Google propose aussi un point d'entrée compatible OpenAI :

https://generativelanguage.googleapis.com/v1beta/openai/

ZSQH AI Gateway

Pour l'interface compatible OpenAI, utilisez :

https://ai.zhongshangqihang.com/v1

Ne mélangez pas les deux : une clé officielle va avec l'adresse officielle, une clé de passerelle avec l'adresse de la passerelle. Un mélange renvoie généralement une erreur 401 ou 404.

4. Test avec curl

export GEMINI_API_KEY="sk-votre-cle"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [
      {"role": "user", "content": "Explique en trois phrases ce qu'est un modèle multimodal"}
    ]
  }'

Le nom du modèle doit être celui affiché sur la page Tarifs des modèles. En cas de model not found, vérifiez d'abord le nom du modèle avant de suspecter la clé.

5. Appel en Python

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GEMINI_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

response = client.chat.completions.create(
    model="gemini-2.5-flash",
    messages=[
        {"role": "user", "content": "Résume les points clés de ce texte : " + "..."}
    ],
)

print(response.choices[0].message.content)

Avec le SDK Google officiel, installez google-genai selon la documentation officielle et utilisez le point d'entrée officiel. Ne mélangez pas les deux approches.

6. Quotas et limitation de débit

Les quotas Gemini dépendent généralement du modèle, du projet, de la région et de la fenêtre de temps. Les limites courantes sont :

requêtes par minute (RPM) ;
tokens par minute (TPM) ;
requêtes par jour (RPD) ;
niveaux gratuit et payant distincts.

Les quotas réels sont ceux de la console Google ou de la console de la passerelle. En production, il est recommandé de :

fixer un plafond de quota par clé ;
appliquer un backoff exponentiel sur les erreurs 429 ;
prévoir un modèle de secours pour les services critiques ;
surveiller le taux d'erreur et la latence jusqu'au premier token.

7. Problèmes courants d'accès depuis la Chine

Symptôme	Cause possible	Traitement
Délai de connexion dépassé	Le réseau ne joint pas Google	Utiliser une passerelle ou un proxy disponible
401	Clé erronée ou URL de base mélangée	Vérifier la correspondance entre clé et adresse
404	`/v1` en trop ou manquant dans le chemin	Contrôler séparément les adresses officielle et passerelle
429	Quota ou fréquence dépassés	Réduire la concurrence, réessayer, augmenter le quota
Modèle indisponible	Région ou compte non activé	Changer de modèle ou de canal
Réponse tronquée	Limite de sortie ou de contexte	Ajuster les paramètres ou découper le texte

8. Estimer le coût

Le coût Gemini dépend généralement des tokens d'entrée, des tokens de sortie et des entrées multimodales telles que les images ou les vidéos. Étapes d'estimation :

Mesurez le nombre moyen de tokens d'entrée et de sortie par requête.
Consultez le prix unitaire du modèle concerné, tel qu'indiqué sur la page Tarifs des modèles.
Multipliez par le nombre de requêtes quotidiennes pour obtenir un coût journalier.
Ajoutez la consommation supplémentaire liée aux nouvelles tentatives, au cache et aux entrées multimodales.

Ne regardez pas seulement le prix « par million de tokens » : le contexte long et les entrées multimodales constituent souvent le principal poste de coût.

9. Recommandations de sécurité

N'écrivez jamais la clé dans le code front-end.
Une clé par personne, avec une séparation par projet au sein de l'équipe.
Définissez un plafond de quota et une date d'expiration.
Renouvelez les clés à intervalles réguliers.
En production, utilisez des variables d'environnement ou un service de gestion des secrets.

Questions fréquentes

La clé API Gemini est-elle utilisable gratuitement ?

Il existe généralement un niveau gratuit, avec des quotas et des restrictions régionales. Pour un usage durable ou commercial, le niveau payant est recommandé ; la politique officielle fait foi.

Une clé peut-elle appeler Claude ?

Dans une passerelle, une même clé peut appeler plusieurs modèles activés ; le modèle est indiqué dans les paramètres de la requête. Une clé Gemini officielle ne peut appeler que les modèles de Google.

Pourquoi un même modèle est-il parfois lent ?

Cela peut dépendre de la charge amont, du réseau régional, de la longueur du contexte et de la concurrence. En production, prévoyez des délais d'attente, des nouvelles tentatives et un canal de secours.

Pour aller plus loin

Si vous avez besoin d'un accès stable depuis la Chine ou d'un point d'entrée multi-modèles, vous pouvez créer un compte ZSQH AI Gateway, créer une clé de test, la valider avec curl, puis intégrer l'application. Les modèles et tarifs applicables sont ceux de la page Tarifs des modèles.