Google AI Studio (aistudio.google.com) est l’atelier de Google pour les développeurs : on y essaie les modèles Gemini, on y crée la clé qui ouvre l’API et on y suit ses dépenses. L’API, elle, permet d’appeler Gemini depuis votre propre programme, en payant au jeton (le morceau de mot que compte le modèle). Depuis l’automne 2026, la documentation de l’API vit aussi sur aistudio.google.com : les anciennes adresses ai.google.dev y renvoient.
Bon à savoir. L’abonnement Google AI Pro ou Ultra de l’appli Gemini ne donne pas de crédit d’API. Les deux se paient à part.
Comment ça marche
Chaque clé appartient à un projet Google Cloud, qui porte la facturation et les quotas. Un nouveau compte reçoit d’office un projet et une clé quand il accepte les conditions. Depuis le 28 mai 2026, les clés créées dans AI Studio sont des clés d’autorisation, liées à un compte de service, et l’API refuse les anciennes clés standard sans restriction.
Votre programme envoie une requête qui nomme le modèle (gemini-4-hydrogen par exemple) et le contenu à traiter. Les modèles Gemini réfléchissent avant de répondre : la réponse contient une étape de réflexion (thought), chiffrée, puis le texte final (model_output). Les jetons de réflexion se paient au prix des jetons de sortie.
Créer sa clé
- Ouvrez aistudio.google.com et connectez-vous avec votre compte Google.
- Acceptez les conditions : AI Studio crée un projet par défaut et une clé.
- Retrouvez la clé dans Dashboard, API keys (adresse directe : aistudio.google.com/api-keys). Le bouton Create API key en crée une autre.
- Si vous avez déjà des projets Google Cloud, importez-les : Dashboard, Projects, Import projects.
- Rangez la clé dans une variable d’environnement, hors du code que vous partagez :
export GEMINI_API_KEY="VOTRE_CLE"
Le premier appel
La documentation met en avant l’API Interactions, servie par les bibliothèques officielles pour Python et JavaScript, ou directement en HTTP.
En Python :
pip install -U google-genai
from google import genai
client = genai.Client() # lit GEMINI_API_KEY
interaction = client.interactions.create(
model="gemini-4-hydrogen",
input="Explique en trois phrases ce qu'est une fenêtre de contexte."
)
print(interaction.output_text)
En JavaScript, la bibliothèque s’installe avec npm install @google/genai. Sans rien installer, avec curl :
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-H "Api-Revision: 2026-05-20" \
-d '{
"model": "gemini-4-hydrogen",
"input": "Explique en trois phrases ce qu'\''est une fenêtre de contexte."
}'
La réponse JSON contient l’identifiant de l’interaction, son état (completed), le décompte des jetons (usage) et les étapes, dont le texte final.
Régler la réflexion
Le paramètre thinking_level remplace l’ancien budget de réflexion chiffré. Il fixe l’effort, donc la qualité, le délai et la facture. D’après la page « Gemini thinking » :
| Modèle | Niveau par défaut | Niveaux possibles |
|---|---|---|
gemini-4-carbon, gemini-4-argon |
medium | low, medium, high |
gemini-4-hydrogen |
high | low, medium, high, xhigh |
gemini-3.8-flash |
medium | low, medium, high |
gemini-3.5-flash-lite |
minimal | minimal, low, medium, high |
Google conseille de partir de high pour un travail complexe, de garder xhigh pour les problèmes en plusieurs étapes où high ne suffit pas, et de choisir le niveau le plus bas qui donne un résultat acceptable. Pour réduire la facture, mieux vaut baisser thinking_level que serrer max_output_tokens : si le modèle atteint cette limite en pleine réflexion, il s’arrête avec l’état incomplete et facture quand même la réflexion déjà produite.
interaction = client.interactions.create(
model="gemini-4-hydrogen",
input="Relis cette fonction et trouve le cas limite qui la casse.",
generation_config={"thinking_level": "low"}
)
Les prix
Les tarifs sont affichés en dollars, par million de jetons, sur le palier payant. Relevé du 17 novembre 2026, mode standard :
| Modèle | Palier gratuit | Entrée | Sortie (réflexion comprise) |
|---|---|---|---|
| Gemini 4 Carbon | non | 2 $ jusqu’au 30 novembre 2026, puis 4 $ | 10 $, puis 20 $ |
| Gemini 4 Argon | non | 2 $ jusqu’au 30 novembre 2026, puis 4 $ | 10 $, puis 20 $ |
| Gemini 4 Hydrogen | oui | 1,50 $ | 7,50 $ |
| Gemini 3.8 Flash | oui | 0,75 $ jusqu’au 31 décembre 2026, puis 1,50 $ | 3,75 $, puis 7,50 $ |
| Gemini 3.5 Flash-Lite | oui | 0,30 $ | 2,50 $ |

Le mode Batch (traitement différé) coûte moitié moins. La recherche Google utilisée pour ancrer les réponses offre 5 000 requêtes par mois partagées entre les modèles Gemini 3 et suivants, puis 14 $ les 1 000. La même page tarife les images (Nano Banana 2 : 0,067 $ l’image en 1K), la vidéo (Gemini Omni 1.2 Flash) et la voix.
Pour situer les modèles de Google face aux autres sur le code, le haut du classement de la semaine :
Le haut du classement Code
- Claude Opus 5.5Anthropic101,4
- Gemini 4 CarbonGoogle DeepMind100,6
- Claude Fable 5.1Anthropic100,1
- Claude Sonnet 5.5Anthropic99,8
- GPT-6 AstraOpenAI99,3
Score Code, édition du 16 novembre 2026. Deux modèles dont les marges se recouvrent sont ex æquo.
Palier gratuit, palier payant et plafond de dépense
Un compte neuf commence sur le palier gratuit : certains modèles, des limites de débit basses, aucun coût. Ailleurs dans le monde, Google se sert alors de vos contenus pour améliorer ses produits. Dans l’Espace économique européen, en Suisse et au Royaume-Uni, les conditions disent que les règles d’usage des données du palier payant s’appliquent à tous les services, gratuits compris. Pour une application ouverte à des utilisateurs de ces pays, seuls les services payants sont permis.
Pour passer au palier payant :
- Sur la page API keys ou Projects d’AI Studio, cliquez sur Set up billing en face du projet.
- Choisissez votre pays, acceptez les conditions, renseignez un moyen de paiement ou choisissez un compte de facturation existant.
- Prépayez au moins 5 $ (ou l’équivalent dans votre devise) de crédits.
Le premier niveau payant plafonne les dépenses à 250 $ par mois sur le compte de facturation, le deuxième à 2 000 $. Vous pouvez fixer un plafond plus bas pour chaque projet : page Spend d’AI Studio, Monthly spend cap, Edit spend cap. Google prévient que ce plafond projet est expérimental : la facturation arrive avec une dizaine de minutes de retard, et un traitement par lots ou une session d’agent peut le dépasser.
Construire sans coder : le mode Build
AI Studio a aussi un mode Build (aistudio.google.com/apps) : vous décrivez une application, il écrit le code (React côté navigateur, Node.js côté serveur, ou une appli Android en Kotlin) et en montre un aperçu à droite. Le bouton Publish la met en ligne sur Cloud Run ; les comptes admissibles au palier Starter de Google Cloud peuvent publier deux applications sans compte de facturation.
Limites et précautions
- Les prix changent en cours de route. Argon, Carbon et 3.8 Flash ont un tarif d’appel avec une date de fin écrite sur la page : refaites vos calculs après le 30 novembre et le 31 décembre 2026.
- Une clé qui fuit coûte cher. Gardez-la hors des dépôts Git et posez un plafond par projet.
- AI Studio s’adresse aux développeurs. Les conditions réservent l’outil à un usage professionnel ; pour discuter au quotidien, l’appli Gemini suffit.
Pour aller plus loin
- Gemini 4 hydrogen
- Gemini 4 argon
- Gemini 4 carbon
- Gemini 3 5 flash lite
- Outils de code et agents
- Jetons, prix au million et vrai coût d'une tâcheNiveau Amateur 5 min
- Gemini : quel modèle choisir, de Flash-Lite à CarbonNiveau Débutant 8 min
- Coder avec Gemini : Antigravity, Canvas, et la fin de JulesNiveau Amateur 12 min
- Claude Code en pratique : terminal, IDE, bureau et webNiveau Amateur 14 min
- Codex, l'agent de code d'OpenAI : terminal, éditeur, appli, nuageNiveau Amateur 15 min
- Harnais : pourquoi un même modèle change d'un outil à l'autreNiveau Amateur 8 min
Pour monter son atelier d'IA à la maison, mini lab AI, du même auteur, va plus loin.
Sources
- Documentation de l'API Gemini, Getting started, lue le
- Documentation de l'API Gemini, Using Gemini API keys, lue le
- Documentation de l'API Gemini, Gemini Developer API pricing, lue le
- Documentation de l'API Gemini, Gemini thinking, lue le
- Documentation de l'API Gemini, Billing (paliers et plafonds), lue le
- Conditions de Google AI Studio et de l'API Gemini, lue le
- Pays où Google AI Studio et l'API Gemini sont ouverts, lue le
- Documentation de l'API Gemini, Models, lue le
- Documentation de Google AI Studio, Build apps, lue le
