Obtenir une clé API Gemini en 2026 : offre gratuite, niveaux payants et limites de débit

Pour obtenir une clé API Gemini, connectez-vous à Google AI Studio avec un compte Google, ouvrez la page API Keys et cliquez sur Create API key (« Créer une clé API »). Les nouveaux utilisateurs reçoivent automatiquement un projet et une clé par défaut après avoir accepté les conditions. Les projets démarrent sur le niveau gratuit (Free tier), qui ne demande aucun moyen de paiement et couvre de nombreux modèles Flash, Flash-Lite et Gemma dans des limites de débit. Gemini 2.5 Pro est aussi gratuit, tandis que Gemini 4 Argon, 3.1 Pro Preview et les modèles d'image et de vidéo nécessitent un niveau payant, et Google indique que les contenus du niveau gratuit servent à améliorer ses produits.

Vérifié dans la documentation de l'API Gemini de Google le 17 octobre 2026. Google modifie souvent les noms des modèles, la couverture du niveau gratuit et les règles des clés ; les dates ci-dessous sont celles que Google publie.

Avant de commencer : qui peut obtenir une clé

• Un compte Google. Un compte Gmail personnel convient. Les comptes professionnels ou scolaires peuvent être limités par les règles Google Cloud de l'organisation (voir la solution aux problèmes de permissions dans le dépannage).
• Avoir 18 ans ou plus. La page des régions de Google cite le fait de ne pas avoir l'âge minimum de 18 ans, ou de ne pas avoir vérifié son âge sur son compte Google, parmi les raisons pour lesquelles AI Studio ne s'ouvre pas.
• Un pays ou territoire pris en charge. Google publie la liste sur sa page des régions disponibles. Les niveaux gratuit et payants sont tous deux proposés dans l'EEE (y compris l'UE), au Royaume-Uni et en Suisse. Si vous êtes hors de la liste, Google renvoie vers l'API Gemini dans Gemini Enterprise Agent Platform. Pour les utilisateurs de Colab, la vérification porte sur l'endroit où s'exécute l'instance Colab, pas sur votre localisation.
• Pas de carte pour le niveau gratuit. Vous n'ajoutez un moyen de paiement que lorsque vous passez un projet à un niveau payant.

Étape 1 : créer la clé dans Google AI Studio

1. Allez sur aistudio.google.com et connectez-vous avec votre compte Google.
2. Acceptez les conditions d'utilisation. Si vous êtes nouveau, AI Studio crée automatiquement un projet Google Cloud par défaut et une clé API pour vous.
3. Ouvrez la page API Keys depuis le tableau de bord.
4. Cliquez sur Create API key si vous avez besoin d'une autre clé. Chaque clé appartient à un projet Google Cloud.
5. Copiez la clé et stockez-la en lieu sûr, par exemple dans un gestionnaire de mots de passe ou de secrets.

Vous utilisez déjà Google Cloud ? AI Studio ne crée pas de projet par défaut pour vous et n'affiche pas tous vos projets Cloud. Importez-en d'abord un : ouvrez le Dashboard, sélectionnez Projects, cliquez sur Import projects, choisissez le projet puis cliquez sur Import. Créez ensuite la clé depuis la page API Keys. AI Studio permet de créer jusqu'à 10 projets à la fois, et ses pages affichent au maximum 100 clés et 50 projets.

Clés d'autorisation et clés standard

Google fait passer l'API Gemini des clés API standard aux clés d'autorisation (auth keys). Une clé d'autorisation est liée à un compte de service Google Cloud, est limitée par défaut à l'API Gemini, et fait l'objet de mesures plus rapides si Google détecte une fuite. Les dates clés publiées par Google :

Si vous avez une ancienne clé marquée Unrestricted sur la page API Keys, survolez le libellé, cliquez sur Add restrictions, choisissez Restrict to Gemini API only et confirmez avec Restrict key, ou créez une nouvelle clé d'autorisation et basculez votre application dessus. La colonne Key Type indique lesquelles de vos clés sont encore Standard.

Étape 2 : définir GEMINI_API_KEY

Les SDK Google Gen AI lisent GEMINI_API_KEY ou GOOGLE_API_KEY depuis votre environnement. Si les deux sont définies, GOOGLE_API_KEY l'emporte. Google recommande les variables d'environnement plutôt que de placer la clé dans le code.

macOS (Zsh)

Ajoutez cette ligne à la fin de ~/.zshrc :

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Puis rechargez le fichier :

source ~/.zshrc

Linux ou macOS (Bash)

Ajoutez la même ligne export à ~/.bashrc, puis rechargez-le :

source ~/.bashrc

Windows

1. Recherchez « Variables d'environnement » (Environment Variables) dans la barre de recherche de Windows.
2. Cliquez sur Variables d'environnement dans la fenêtre Propriétés système.
3. Sous Variables utilisateur ou Variables système, cliquez sur Nouvelle....
4. Indiquez GEMINI_API_KEY comme nom de variable et votre clé comme valeur.
5. Cliquez sur OK, puis ouvrez un nouveau terminal pour qu'il prenne en compte la variable.

Étape 3 : effectuer une requête de test

Installez le SDK officiel. Python :

pip install -U google-genai

JavaScript :

npm install @google/genai

Avec GEMINI_API_KEY définie, le client trouve la clé tout seul. Un test Python minimal avec l'Interactions API de Google :

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words"
)
print(interaction.output_text)

Le même en JavaScript :

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);

Ou appelez directement l'API REST avec curl. Voici l'exemple de Google tiré de la page des clés API ; remplacez YOUR_API_KEY par votre clé :

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

Un appel réussi renvoie une interaction avec "status": "completed", l'usage de tokens et le texte du modèle. Si vous obtenez une erreur, consultez la section de dépannage ci-dessous. Les noms de modèles changent souvent : vérifiez les ID actuels sur la page des modèles de Google avant d'en coder un en dur.

L'API Gemini est-elle gratuite ?

Oui, pour de nombreux modèles, dans des limites de débit. La page des tarifs de Google indique ces modèles comme Free of charge (gratuits) sur le niveau gratuit (entrée et sortie standard) :

• Gemini 3.8 Flash, 3.6 Flash et 3 Flash Preview
• Gemini 3.5 Flash-Lite et 3.1 Flash-Lite
• Gemini 2.5 Pro, 2.5 Flash et 2.5 Flash-Lite
• Les modèles Live, TTS et Transcribe comme Gemini 3.8 Live, 3.8 Flash TTS et 3.5 Transcribe
• Gemini Embedding 2, Gemini Robotics ER 2 Preview et Gemma 4

Ceux-ci n'ont pas de niveau gratuit : Gemini 4 Argon, Gemini 3.1 Pro Preview, Gemini Omni Flash, les modèles d'image (Nano Banana 2.1, Nano Banana 2, Nano Banana Pro et 2.5 Flash Image), Veo et Lyria. L'ancrage via Google Search et Google Maps sur Gemini 3 et les modèles plus récents est aussi réservé aux niveaux payants. Pour les tarifs par token, consultez les prix de l'API Gemini, et pour un résumé du niveau gratuit, notre page offre gratuite de l'API Gemini.

Sur le niveau gratuit, la page des tarifs de Google indique que les contenus sont « Used to improve our products » (utilisés pour améliorer nos produits). L'usage standard des niveaux payants n'est pas utilisé ainsi. N'envoyez pas de données confidentielles, clients ou personnelles depuis un projet du niveau gratuit.

Limites de débit de l'API Gemini

Google mesure les limites en requêtes par minute (RPM), tokens d'entrée par minute (TPM) et requêtes par jour (RPD). Dépasser l'une d'entre elles provoque une erreur, même si vous êtes sous les autres. Certains modèles ont des limites supplémentaires, comme le nombre d'images par minute pour les modèles d'image ou les tokens par jour. Les limites s'appliquent par projet, pas par clé API : des clés supplémentaires dans le même projet n'ajoutent donc pas de quota. Le RPD se réinitialise à minuit, heure du Pacifique. Les modèles expérimentaux et en préversion ont des limites plus strictes.

Google ne publie pas de tableau fixe des chiffres du niveau gratuit. Les limites varient selon le modèle et le niveau, et vous voyez vos limites actives dans AI Studio sur aistudio.google.com/rate-limit. Google précise aussi que les limites indiquées ne sont pas garanties.

Les Tier 2 et Tier 3 se basent sur les dépenses Google Cloud cumulées (pas seulement Gemini) du compte de facturation lié, et les passages de niveau sont automatiques. Le passage du gratuit au Tier 1 prend généralement effet instantanément ; les suivants en une dizaine de minutes environ. L'application de limites basées sur les dépenses dépend de votre historique de facturation ; en atteindre une renvoie 429 RESOURCE_EXHAUSTED. Si vous atteignez régulièrement les limites en usage normal sur un niveau payant, Google propose un formulaire pour demander une hausse, sans garantie.

Tirer le meilleur des limites gratuites

• Choisissez le bon modèle pour chaque tâche. Les limites diffèrent selon le modèle et les préversions sont plus strictes : comparez vos chiffres sur la page des limites et réservez les modèles de classe Pro aux prompts qui en ont besoin.
• Réduisez le raisonnement. Google note que les modèles Gemini 3.x raisonnent (thinking) par défaut, ce qui ajoute de la latence et des tokens. Baisser le niveau de raisonnement réduit la consommation de tokens pour les prompts simples.
• Réessayez avec un délai croissant. Les SDK de Google relancent automatiquement les erreurs 429 et 5xx (le SDK Python jusqu'à quatre fois). Dans votre propre code REST, attendez 1 s, 2 s, 4 s, etc., avec un peu d'aléa.
• Des projets distincts pour des applications distinctes. Les limites étant par projet, un script de test ne peut pas priver votre application de démo de quota s'ils sont dans des projets différents. Ne le faites pas pour contourner les limites d'une même application : c'est contraire à l'esprit des conditions, et les niveaux sont de toute façon suivis au niveau du compte de facturation.

Passer à un niveau payant

1. Dans AI Studio, allez sur la page API keys ou Projects.
2. Trouvez le projet du niveau gratuit à faire évoluer et cliquez sur Set up billing dans la colonne Billing Tier.
3. Si vous n'avez jamais eu de compte de facturation Google, choisissez votre pays pour accepter les conditions, puis confirmez vos coordonnées et votre moyen de paiement. Si vous en avez un, choisissez un compte de facturation existant ou cliquez sur Add new billing account.
4. Prépayez au moins 5 $ (ou l'équivalent local) si on vous le demande. Certains comptes se voient proposer le paiement différé (Postpay) à la place.

Les nouveaux utilisateurs sont par défaut sur le plan Prepay (prépayé), entré en vigueur le 23 mars 2026. Vous achetez des crédits sur la page Billing d'AI Studio (minimum 5 $, maximum 5 000 $), l'usage est déduit quasiment en temps réel, et les crédits inutilisés expirent après 12 mois et ne sont pas remboursables. Quand le solde atteint 0 $, toutes les clés de tous les projets liés à ce compte de facturation cessent de fonctionner et les requêtes échouent avec une erreur HTTP 402 jusqu'à ce que vous ajoutiez des crédits. La recharge automatique et une limite mensuelle de débit automatique aident à éviter les mauvaises surprises, et vous pouvez définir des plafonds de dépenses par projet sur la page Spend.

Pour revenir au niveau gratuit, désactivez la facturation sur le projet (ou dissociez-le de son compte de facturation).

Exemple de coût chiffré

Avec le prix payant standard de Google pour Gemini 3.8 Flash jusqu'au 31 décembre 2026 (0,75 $ par million de tokens en entrée et 3,75 $ par million de tokens en sortie, les tokens de raisonnement étant facturés comme de la sortie) : 1 000 requêtes de 2 000 tokens en entrée et 500 tokens en sortie chacune consomment 2M tokens en entrée et 0,5M tokens en sortie. Cela fait 2 × 0,75 $ = 1,50 $ plus 0,5 × 3,75 $ = 1,875 $, soit environ 3,38 $ au total. Google indique que ces tarifs doubleront à partir du 1er janvier 2027, ce qui porterait la même charge à environ 6,75 $. Les mêmes requêtes sur le niveau gratuit ne coûtent rien, tant qu'elles respectent vos limites de débit.

L'essai gratuit Google Cloud de 300 $ ne peut pas payer l'usage de l'API Gemini. Google indique qu'à partir de mars 2026, les coûts de l'API Gemini sont exclus du programme, et que les crédits de bienvenue des comptes de facturation ouverts après le 2 mars 2026 ne peuvent pas être utilisés pour l'API Gemini ni pour AI Studio. Les comptes qui ont reçu le crédit avant peuvent dépenser le reste sur l'API Gemini jusqu'à son expiration. Les startups peuvent demander des crédits via le Google for Startups Cloud Program.

Protéger votre clé API Gemini

• Traitez la clé comme un mot de passe et ne la commitez jamais dans Git.
• Ne codez pas les clés en dur dans des applications web ou mobiles : n'importe qui peut les extraire. Appelez plutôt Gemini depuis un proxy backend.
• Lisez la clé depuis une variable d'environnement, et conservez les clés de production dans un gestionnaire de secrets comme Google Cloud Secret Manager.
• Restreignez les clés : sur la page des identifiants de la console Google Cloud, ajoutez des restrictions d'application comme des adresses IP autorisées.
• Configurez des alertes de facturation dans la console Google Cloud et un plafond de dépenses par projet dans AI Studio, pour qu'une clé qui fuite ne puisse pas générer une grosse facture.

Si votre clé a fuité

1. Créez une clé de remplacement dans AI Studio ou la console Cloud.
2. Déployez votre application avec la nouvelle clé.
3. Désactivez la clé compromise une fois la nouvelle fonctionnelle, puis supprimez-la.
4. Vérifiez la facturation et l'usage de l'API dans la console Google Cloud pour repérer toute activité inconnue. En cas de frais inattendus, Google vous demande d'ouvrir une demande d'assistance facturation.

Dépannage

Les requêtes échouées avec une erreur 400 ou 500 ne sont pas facturées, mais Google précise qu'elles comptent quand même dans votre quota.

À quoi servir le niveau gratuit, et alternatives

Le niveau gratuit suffit pour apprendre, prototyper, participer à des hackathons, faire tourner des scripts personnels et des outils internes à faible trafic. Passez à un niveau payant quand vous avez besoin de limites de débit adaptées à la production, d'un modèle Pro ou d'image, ou quand vos données ne doivent pas servir à améliorer les produits Google. Si vous voulez un abonnement Gemini pour l'application de chat plutôt qu'un accès API, c'est un produit distinct ; consultez les prix des plans Google AI, et les étudiants ont intérêt à regarder l'offre Google AI Pro gratuite pour les étudiants.

D'autres fournisseurs proposent aussi un accès API gratuit, chacun avec ses limites et sa politique de données. Comparez-les dans notre guide des clés API IA gratuites, ou consultez l'offre gratuite de l'API Groq, l'offre gratuite de l'API Mistral et les modèles gratuits d'OpenRouter. Si vous avez plutôt besoin de Claude, consultez comment obtenir une clé API Anthropic. Pour une vue d'ensemble de tous les programmes de crédits que nous suivons, commencez par comment obtenir des crédits IA gratuits.