# Aan de slag met de Gemini API: API-sleutel, SDK en je eerste aanvraag

De Gemini API geeft je vanuit je eigen code toegang tot de Gemini-modellen van Google. Je stuurt een tekst- of afbeeldingsprompt en krijgt een gegenereerd antwoord terug, dat je in je eigen applicatie verwerkt. Deze gids laat zien hoe je in een paar minuten van niets naar een werkende eerste aanvraag gaat.

## Een API-sleutel aanmaken

Alle aanvragen worden geauthenticeerd met een API-sleutel. Die maak je aan in **Google AI Studio**:

- Ga naar [aistudio.google.com/apikey](https://aistudio.google.com/apikey) en log in met je Google-account.
- Klik op de knop om een nieuwe API-sleutel aan te maken en koppel die aan een Google Cloud-project.
- Kopieer de sleutel en bewaar hem op een veilige plek.

:::warn title="Een API-sleutel is een geheim"
Behandel je sleutel als een wachtwoord. Zet hem **nooit** in front-end code, in een publieke repository of in een mobiele app, want daar kan iedereen hem uitlezen. Lekt een sleutel toch, trek hem dan direct in via Google AI Studio en maak een nieuwe aan.
:::

## Je sleutel beperken (sinds juni 2026 verplicht)

Sinds 19 juni 2026 weigert Google API-aanvragen met sleutels die geen API-beperking hebben. Een onbeperkte sleutel die per ongeluk lekt, kan namelijk binnen enkele uren een flinke rekening opleveren. Beperk je sleutel daarom expliciet tot de Gemini API:

:::howto title="Zo beperk je je sleutel"
1. Ga in de Google Cloud Console naar **APIs en services**, daarna **Inloggegevens**.
2. Open de API-sleutel die Gemini mag aanroepen.
3. Kies bij **API-beperkingen** voor **Sleutel beperken** en selecteer alleen de **Generative Language API**.
4. Sla op. Nieuwe sleutels die je via Google AI Studio aanmaakt, zijn doorgaans al correct beperkt.
:::

## De officiele SDK installeren

Google biedt de **Google Gen AI SDK** als officiele bibliotheek. Let op: oudere pakketten zoals `google-generativeai` en `@google/generative-ai` zijn sinds eind 2025 verouderd. Gebruik voor nieuwe projecten dus de nieuwe SDK.

- **Python**: `pip install google-genai`
- **Node.js**: `npm install @google/genai`

Daarnaast kun je de API ook rechtstreeks via REST aanroepen, zonder SDK, als je liever met `curl` of een eigen HTTP-client werkt.

## Je sleutel veilig instellen

Geef je sleutel door via een omgevingsvariabele in plaats van hem hard in je code te zetten. De SDK leest standaard de variabele `GEMINI_API_KEY`:

```bash
export GEMINI_API_KEY="jouw-sleutel-hier"
```

:::tip title="Gebruik een .env-bestand"
Zet je sleutel tijdens ontwikkeling in een `.env`-bestand en plaats dat bestand in je `.gitignore`. Zo voorkom je dat je sleutel per ongeluk in versiebeheer belandt. Stel je zowel `GEMINI_API_KEY` als `GOOGLE_API_KEY` in, dan heeft `GOOGLE_API_KEY` voorrang, dus zet bij voorkeur maar een van beide.
:::

## Je eerste aanvraag in Python

Met de sleutel in de omgeving hoef je de SDK alleen nog te initialiseren. De client pakt `GEMINI_API_KEY` automatisch op:

```python
from google import genai

client = genai.Client()
response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Leg in twee zinnen uit wat een API is."
)
print(response.text)
```

Het antwoord van het model staat in `response.text`. Het `model`-veld bepaalt welk Gemini-model je aanspreekt; hierover meer in de paragraaf hieronder.

## Je eerste aanvraag in Node.js

In JavaScript en TypeScript werkt het vrijwel identiek, met de methode `generateContent`:

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

const ai = new GoogleGenAI({});
const response = await ai.models.generateContent({
  model: "gemini-2.5-flash",
  contents: "Leg in twee zinnen uit wat een API is.",
});
console.log(response.text);
```

## Welk model kies je?

De modelnaam bepaalt de balans tussen snelheid, kosten en redeneervermogen. Een paar veelgebruikte opties medio 2026:

- **gemini-2.5-flash** is snel en geschikt voor de meeste alledaagse taken zoals samenvatten, classificeren en korte antwoorden. Een prima startpunt.
- **gemini-2.5-flash-lite** is de budgetvriendelijke variant voor eenvoudige taken op grote schaal.
- De nieuwere **Gemini 3**-generatie (zoals `gemini-3.5-flash` en `gemini-3.1-flash-lite`) levert sterkere redeneer- en agentprestaties. `gemini-3.5-flash` is op dit moment het aanbevolen algemene model.
- De **Pro**-modellen zijn krachtiger en bedoeld voor complexere redeneertaken; ze zijn doorgaans duurder en trager.

:::info title="Controleer altijd de actuele modelnamen"
Google brengt regelmatig nieuwe modelversies uit en zet oude versies stop. Zo zijn de Gemini 1.0- en 1.5-modellen al uitgefaseerd en stoppen de 2.0-modellen vanaf juni 2026. Controleer de officiele modellenpagina van de Gemini API voor de actuele namen, mogelijkheden en uitfaseringsdata voordat je een model vastlegt in productie.
:::

## Volgende stappen

Je hebt nu een werkende verbinding met de Gemini API. Daarmee kun je verder bouwen: systeeminstructies meegeven om de toon te sturen, antwoorden als JSON laten teruggeven, of de uitvoer streamen voor een vlottere gebruikerservaring. Houd je API-sleutel altijd op de server, monitor je verbruik in Google AI Studio en stel waar mogelijk een uitgavenlimiet in op je Google Cloud-project.

:::faq
### Werkt mijn code nog als ik gemini-2.5-flash gebruik?
Ja. `gemini-2.5-flash` is medio 2026 nog een stabiel, ondersteund model en een goed startpunt. Wil je de sterkste prestaties, wissel dan de modelnaam om naar een Gemini 3-model zoals `gemini-3.5-flash`. De rest van je code blijft hetzelfde.

### Waarom krijg ik na 19 juni 2026 een authenticatiefout?
Sinds die datum weigert Google sleutels zonder API-beperking. Open je sleutel in de Google Cloud Console, beperk hem tot de Generative Language API en sla op. Daarna werken je aanvragen weer.

### Moet ik GEMINI_API_KEY of GOOGLE_API_KEY instellen?
De SDK pakt beide automatisch op. Stel bij voorkeur maar een van de twee in. Heb je ze allebei staan, dan heeft `GOOGLE_API_KEY` voorrang.

### Welk oud pakket moet ik niet meer gebruiken?
De pakketten `google-generativeai` (Python) en `@google/generative-ai` (Node.js) zijn verouderd. Gebruik voor nieuwe projecten `google-genai` en `@google/genai`.

### Kan ik de Gemini API zonder SDK gebruiken?
Ja. Je kunt de API rechtstreeks via REST aanroepen met `curl` of een eigen HTTP-client. De SDK is een handige laag eromheen, maar geen vereiste.

### Hoe voorkom ik een onverwacht hoge rekening?
Houd je sleutel op de server, beperk hem tot de Generative Language API en stel een uitgavenlimiet in op je Google Cloud-project. Monitor je verbruik regelmatig in Google AI Studio.
:::