De Gemini API geeft ontwikkelaars toegang tot de modellen van Google in eigen applicaties. In dit artikel zet je de eerste stappen: een API-sleutel aanmaken en beperken, een eerste verzoek doen en veilig met je sleutel omgaan. Geen overbodige theorie, wel een werkbare basis.
Wat de Gemini API biedt
Met de Gemini API stuur je vanuit je eigen code een prompt naar een Gemini-model en krijg je een gegenereerd antwoord terug. Zo bouw je AI-functies in je applicatie: een chatbot, een samenvattingsfunctie, classificatie van tekst of beeldherkenning, allemaal aangedreven door Gemini.
De API ondersteunt dezelfde modelfamilies die je uit de webversie kent. In juni 2026 zijn de gangbare keuzes Gemini 3 Flash en de Gemini 2.5-familie (Flash, Flash-Lite en Pro) voor de meeste werk, en Gemini 3.1 Pro wanneer je de sterkste redeneer- en codeercapaciteit nodig hebt. Zo kies je per use case de juiste balans tussen snelheid, kwaliteit en kosten. Zie het modeloverzicht voor de afweging.
AI Studio als startpunt
Google AI Studio is de snelste plek om te beginnen. Je test er prompts, kiest een model en genereert een API-sleutel, allemaal zonder lokale setup. Zie Google AI Studio voor de details.
Een API-sleutel aanmaken en beperken
Je hebt een API-sleutel nodig om verzoeken te authenticeren. Die maak je aan in Google AI Studio. De sleutel koppelt je verzoeken aan je account en eventuele facturering. Voor nieuwe gebruikers maakt AI Studio na het accepteren van de voorwaarden automatisch een standaard Google Cloud-project met een eerste sleutel aan.
Onbeperkte sleutels stoppen op 19 juni 2026
Google schakelt vanaf 19 juni 2026 ondersteuning voor onbeperkte sleutels uit. Verzoeken met een niet-beperkte sleutel falen daarna. Open je sleutels op de API-keys-pagina in AI Studio en klik per sleutel op de knop om hem te beperken tot de Gemini API. Doe dit voor je in productie gaat.
Aan de slag met de Gemini API
- Ga naar Google AI Studio en log in met je Google-account.
- Maak een nieuwe API-sleutel aan in het sleutelbeheer en beperk hem direct tot de Gemini API.
- Bewaar de sleutel in een omgevingsvariabele, niet in je broncode.
- Installeer de officiele client-bibliotheek voor je programmeertaal, bijvoorbeeld
google-genaivoor Python of@google/genaivoor JavaScript. - Doe een eerste verzoek met een eenvoudige prompt naar een model als
gemini-2.5-flashen verwerk het antwoord.
Je eerste verzoek
Een verzoek bestaat in de kern uit het kiezen van een model en het meesturen van je prompt. De officiele client-bibliotheken voor talen zoals Python en JavaScript maken dit eenvoudig: je initialiseert de client met je sleutel, kiest een model en roept een functie aan om inhoud te genereren.
Het antwoord bevat de gegenereerde tekst, die je vervolgens in je applicatie toont of verder verwerkt. Begin met een simpele tekstprompt voordat je geavanceerdere functies zoals streaming of multimodale invoer toevoegt.
De stappen op een rij:
- Sleutel: maak een API-sleutel, beperk hem tot de Gemini API en beveilig hem.
- Client: initialiseer de client-bibliotheek met je sleutel uit een omgevingsvariabele.
- Verzoek: stuur een model en een prompt naar het endpoint.
- Antwoord: lees de gegenereerde tekst uit en verwerk die in je applicatie.
Veilig omgaan met je sleutel
Je API-sleutel is een geheim. Wie hem heeft, kan op jouw kosten verzoeken doen. Behandel hem daarom als een wachtwoord. Bewaar hem in een omgevingsvariabele of een secret manager, nooit hardcoded in je broncode of in clientcode die naar de browser gaat.
Nooit een API-sleutel in clientcode
Plaats je sleutel nooit in frontend-code, een publieke repository of een mobiele app-bundel. Aanvallers scannen actief op gelekte sleutels. Roep de API aan vanaf je backend en houd de sleutel serverseidig. Lekt een sleutel toch, roteer hem dan meteen in AI Studio.
Verzoeken en kosten beheren
Houd rekening met rate limits en kosten. Voor ontwikkeling en test begin je met een snel, goedkoop model. Gemini 3 Flash geldt sinds begin 2026 als de aanbevolen standaard op het gratis niveau; Gemini 2.5 Flash kost ongeveer 0,30 dollar per miljoen invoertokens en Flash-Lite ligt daar nog onder. Pro-modellen leveren sterker redeneren, maar zijn duurder en zijn sinds april 2026 alleen op een betaald niveau beschikbaar. Vang fouten netjes af, bouw een retry met oplopende vertraging in voor tijdelijke fouten, en log verzoeken zodat je verbruik en problemen kunt volgen.
Test eerst in AI Studio
Voordat je een prompt in code giet, test je hem in Google AI Studio. Je ziet daar direct hoe het model reageert en kunt de prompt verfijnen, wat je veel codewijzigingen bespaart.
Houd rekening met kosten
API-gebruik wordt afgerekend per verwerkte hoeveelheid tekst, gemeten in tokens voor zowel invoer als uitvoer. Stel budgetlimieten in, gebruik lichtere modellen waar mogelijk, en cache antwoorden op herhaalde verzoeken om kosten te beheersen.
Heb ik een betaald account nodig?
Er is een gratis niveau met limieten om te beginnen, dat in juni 2026 de Flash- en Flash-Lite-modellen omvat. Voor de Pro-modellen en voor productiegebruik met hogere volumes stap je over op een betaald niveau.
Welke talen worden ondersteund?
Er zijn officiele client-bibliotheken voor onder meer Python en JavaScript, en daarnaast bibliotheken voor andere populaire talen. Je kunt de API ook rechtstreeks via HTTP aanroepen.
Welk model kies ik om te beginnen?
Begin met een snel Flash-model zoals Gemini 3 Flash of Gemini 2.5 Flash. Die zijn goedkoop en snel genoeg voor de meeste functies. Schakel pas over naar een Pro-model wanneer je sterker redeneren of complexe codetaken nodig hebt.
Kan ik afbeeldingen meesturen?
Ja, de modellen zijn multimodaal. Je kunt naast tekst ook afbeeldingen en andere invoer meesturen, afhankelijk van het gekozen model.
Waarom falen mijn verzoeken sinds juni 2026?
Mogelijk gebruik je een onbeperkte sleutel. Google stopt vanaf 19 juni 2026 met onbeperkte sleutels. Open je sleutel in AI Studio en beperk hem tot de Gemini API om verzoeken weer te laten slagen.
Hoe houd ik mijn sleutel veilig?
Bewaar hem serverseidig in een omgevingsvariabele of secret manager, beperk hem tot de Gemini API, gebruik hem nooit in clientcode of publieke repositories, en roteer hem als je vermoedt dat hij gelekt is.
Wil je prompts en modellen verkennen voordat je codeert? Begin in Google AI Studio. Voor sterkere prompts in je API-calls gebruik je het PTCF-framework.