Clé API Gemini dans Google AI Studio

Pour obtenir une clé API Gemini, ouvrez Google AI Studio à l'adresse aistudio.google.com/apikey. Un nouvel utilisateur reçoit automatiquement un projet Google Cloud et une clé après avoir accepté les conditions d'utilisation. Si vous avez déjà un compte Google Cloud, importez d'abord vos projets (Dashboard › Projects › Import projects), puis créez la clé dans le projet voulu depuis la page API Keys. C'est la marche décrite par la documentation de Google lue le 15/11/2026.

Les étapes

1. Aller sur aistudio.google.com/apikey avec le compte Google de l'entreprise (pas un compte personnel, si la clé doit servir à un projet de l'entreprise).
2. Accepter les conditions : un projet Google Cloud et une clé sont créés par défaut pour un nouvel utilisateur.
3. Ou importer un projet existant : Dashboard, puis Projects, puis Import projects ; ensuite, page API Keys, créer la clé dans ce projet.
4. Ranger la clé : la documentation demande de la traiter comme un mot de passe et de ne jamais la publier dans un dépôt de code.

Les nouvelles clés créées dans AI Studio sont, par défaut, des clés d'authentification liées à un compte de service.

Tester la clé

Placez la clé dans GEMINI_API_KEY ou GOOGLE_API_KEY : les bibliothèques de Google détectent l'une ou l'autre, et GOOGLE_API_KEY l'emporte si les deux existent. La documentation propose ce test, avec la clé dans l'en-tête x-goog-api-key :

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Api-Revision: 2026-05-20" \
  -X POST \
  -d '{
    "model": "gemini-4-hydrogen",
    "input": "Explain how AI works in a few words"
  }'

Gardez l'en-tête Api-Revision tel qu'il figure dans l'exemple officiel.

Offre gratuite et offre payante : la vraie différence

C'est le point à vérifier avant d'envoyer des données d'entreprise. Sur la page tarifs de l'API Gemini, chaque modèle porte une ligne « utilisé pour améliorer nos produits » :

Autrement dit, l'offre gratuite convient à un essai avec des données fictives ; pour des documents clients, des devis ou des données personnelles, passez en offre payante. Les prix au million de jetons sont sur la page tarifs.

Passer en offre payante

Les limites de débit Gemini s'appliquent par projet, pas par clé, et augmentent par paliers :

Remplir les conditions mène en général au palier supérieur, sans garantie. Les quotas par jour se remettent à zéro à minuit, heure du Pacifique. Le détail des dépassements est sur la page erreur 429.

Sécurité : ce que dit Google

• Ne codez pas la clé en dur dans une application web ou mobile.
• Pour une application côté navigateur, faites passer les appels par un serveur intermédiaire (proxy) qui détient la clé.
• Ajoutez des restrictions à la clé pour limiter les dégâts en cas de fuite.
• En production, rangez-la dans un gestionnaire de secrets (Google Cloud Secret Manager, par exemple) et réglez des alertes de facturation.

La page protéger sa clé API reprend ces règles pour les trois éditeurs.