Aller au contenu
EN 4 QUESTIONSTrouver mon modèle
Code · guide expert · 14 min de lecture

API Gemini et Google AI Studio : clé, premier appel, prix

Google AI Studio sert à essayer les modèles Gemini et à créer la clé de l'API. Voici le premier appel en Python ou en curl, le réglage de la réflexion, les prix affichés et le plafond de dépense, avec la règle qui change tout en Europe pour le palier gratuit.

Disponible en France

Illustration du dossier Google

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

Un appel à l'API Gemini : la clé, la requête, la réflexion puis la réponse, et ce qui change entre le palier gratuit et le palier payant. D'après la documentation de Google, lue le 17 novembre 2026.

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é

  1. Ouvrez aistudio.google.com et connectez-vous avec votre compte Google.
  2. Acceptez les conditions : AI Studio crée un projet par défaut et une clé.
  3. Retrouvez la clé dans Dashboard, API keys (adresse directe : aistudio.google.com/api-keys). Le bouton Create API key en crée une autre.
  4. Si vous avez déjà des projets Google Cloud, importez-les : Dashboard, Projects, Import projects.
  5. 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 $
Page Gemini Developer API pricing, section Gemini 4 Hydrogen : onglets Standard, Batch, Flex, Priority, Contributor, puis tableau Free Tier et Paid Tier avec Input price 1,50 dollar, Output price 7,50 dollars, Context caching 0,075 dollar et Grounding with Google Search.
La ligne de Gemini 4 Hydrogen sur la page de tarifs de l'API : gratuit sur le palier gratuit, 1,50 dollar le million de jetons en entrée et 7,50 dollars en sortie sur le palier payant (capture du 17 novembre 2026, aistudio.google.com).

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

  1. Claude Opus 5.5Anthropic101,4
  2. Gemini 4 CarbonGoogle DeepMind100,6
  3. Claude Fable 5.1Anthropic100,1
  4. Claude Sonnet 5.5Anthropic99,8
  5. GPT-6 AstraOpenAI99,3

Score Code, édition du 16 novembre 2026. Deux modèles dont les marges se recouvrent sont ex æquo.

Classement Code des modèles de langage →

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 :

  1. Sur la page API keys ou Projects d’AI Studio, cliquez sur Set up billing en face du projet.
  2. Choisissez votre pays, acceptez les conditions, renseignez un moyen de paiement ou choisissez un compte de facturation existant.
  3. 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

Pour monter son atelier d'IA à la maison, mini lab AI, du même auteur, va plus loin.

Tous les guides →

Sources

  1. Documentation de l'API Gemini, Getting started, lue le
  2. Documentation de l'API Gemini, Using Gemini API keys, lue le
  3. Documentation de l'API Gemini, Gemini Developer API pricing, lue le
  4. Documentation de l'API Gemini, Gemini thinking, lue le
  5. Documentation de l'API Gemini, Billing (paliers et plafonds), lue le
  6. Conditions de Google AI Studio et de l'API Gemini, lue le
  7. Pays où Google AI Studio et l'API Gemini sont ouverts, lue le
  8. Documentation de l'API Gemini, Models, lue le
  9. Documentation de Google AI Studio, Build apps, lue le