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

> Créer sa clé dans Google AI Studio, faire un premier appel à l'API Gemini, régler la réflexion, lire les prix au million de jetons et plafonner ses dépenses.

- Niveau : Expert
- Thème : Code
- Durée : 14 minutes
- Systèmes : Mac, Windows, Linux, Navigateur
- Disponible en France : La France figure dans la liste des pays de Google AI Studio et de l'API. Pour une application proposée à des utilisateurs de l'Espace économique européen, Google n'autorise que les services payants. (https://aistudio.google.com/docs/available-regions, lue le 17 novembre 2026)
- Publié le 17 novembre 2026, relu le 17 novembre 2026
- Auteur : Ulrich Rozier
- Page : https://quelleia.com/guides/gemini-api-et-ai-studio/

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.](https://quelleia.com/guides/gemini-api-et-ai-studio/appel-api-gemini.svg)

*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 :

```bash
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 :

```bash
pip install -U google-genai
```

```python
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 :

```bash
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.

```python
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.](https://quelleia.com/guides/gemini-api-et-ai-studio/tarif-gemini-4-hydrogen.webp)

*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.5](https://quelleia.com/modeles/claude-opus-5-5/) : 101,4 (Anthropic)
2. [Gemini 4 Carbon](https://quelleia.com/modeles/gemini-4-carbon/) : 100,6 (Google DeepMind)
3. [Claude Fable 5.1](https://quelleia.com/modeles/claude-fable-5-1/) : 100,1 (Anthropic)
4. [Claude Sonnet 5.5](https://quelleia.com/modeles/claude-sonnet-5-5/) : 99,8 (Anthropic)
5. [GPT-6 Astra](https://quelleia.com/modeles/gpt-6-astra/) : 99,3 (OpenAI)

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](https://quelleia.com/classement/code/)

## 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

- [Google](https://quelleia.com/editeurs/google/)
- [Gemini 4 hydrogen](https://quelleia.com/modeles/gemini-4-hydrogen/)
- [Gemini 4 argon](https://quelleia.com/modeles/gemini-4-argon/)
- [Gemini 4 carbon](https://quelleia.com/modeles/gemini-4-carbon/)
- [Gemini 3 5 flash lite](https://quelleia.com/modeles/gemini-3-5-flash-lite/)
- [Outils de code et agents](https://quelleia.com/outils/)
- [Jetons, prix au million et vrai coût d'une tâche](https://quelleia.com/guides/jetons-et-prix.md) (guide, amateur)
- [Gemini : quel modèle choisir, de Flash-Lite à Carbon](https://quelleia.com/guides/gemini-quel-modele.md) (guide, débutant)
- [Coder avec Gemini : Antigravity, Canvas, et la fin de Jules](https://quelleia.com/guides/gemini-pour-coder.md) (guide, amateur)

## Sources

- https://aistudio.google.com/docs/quickstart (lue le 17 novembre 2026)
- https://aistudio.google.com/docs/api-key (lue le 17 novembre 2026)
- https://aistudio.google.com/docs/pricing (lue le 17 novembre 2026)
- https://aistudio.google.com/docs/thinking (lue le 17 novembre 2026)
- https://aistudio.google.com/docs/billing (lue le 17 novembre 2026)
- https://aistudio.google.com/docs/terms (lue le 17 novembre 2026)
- https://aistudio.google.com/docs/available-regions (lue le 17 novembre 2026)
- https://aistudio.google.com/docs/models (lue le 17 novembre 2026)
- https://aistudio.google.com/docs/aistudio-build-mode (lue le 17 novembre 2026)
