Een sleutel maken in vier stappen
- Ga naar de pagina API Keys in Google AI Studio (aistudio.google.com/apikey).
- Heeft je bedrijf al een Google Cloud-account, importeer dan eerst je projecten via Projects in het dashboard. Elke sleutel hoort bij een Google Cloud-project; daar regel je facturering, collega’s en rechten.
- Maak de sleutel aan. Is de knop grijs, dan mis je rechten in dat project, zoals die van de rol Project Editor.
- Zet de sleutel in een omgevingsvariabele:
GEMINI_API_KEYofGOOGLE_API_KEY. Staan ze allebei, dan gaatGOOGLE_API_KEYvoor.
Sinds 28 mei 2026 is elke nieuwe sleutel een authorization key: gekoppeld aan een serviceaccount, zodat je in Google Cloud ziet onder welke identiteit een aanvraag liep, en standaard beperkt tot de Gemini API. Google weigert onbeperkte standaardsleutels en blokkeert sinds 7 mei 2026 onbeperkte sleutels die niet gebruikt worden.
Kosteloos of betaald: het verschil zit in je data
Dezelfde sleutel kan op de kosteloze of de betaalde laag draaien. Zakelijk is dat het belangrijkste verschil, niet de prijs. Volgens de voorwaarden van de Gemini API, per november 2026:
| Kosteloze laag | Betaalde laag | |
|---|---|---|
| Prompts en antwoorden gebruikt om producten te verbeteren | Ja | Nee |
| Menselijke beoordelaars kunnen input en output lezen | Ja, losgekoppeld van je account en project | Niet genoemd |
| Logging | Niet gespecificeerd | Een beperkte tijd, alleen om misbruik op te sporen |
| Nieuwste modellen, zoals Gemini 4 Argon | Niet beschikbaar | Beschikbaar |
Upgraden doe je via Upgrade to Paid in AI Studio, door facturering aan het project te koppelen.
Voor Nederlandse bedrijven speelt nog iets: in de EER, Zwitserland en het VK gelden de dataregels van de betaalde diensten voor alle diensten, ook de kosteloze. En maak je een toepassing beschikbaar voor gebruikers in de EER, dan mag je volgens de voorwaarden alleen betaalde diensten gebruiken.
Het misverstand: “het is maar een testsleutel”
Veel teams beginnen met een kosteloze sleutel op iemands eigen Google-account en bouwen daar ongemerkt op door. Drie risico’s:
- De sleutel hangt aan een persoon. Vertrekt die collega, dan draait je toepassing op een project dat het bedrijf niet beheert. Maak de sleutel in een Google Cloud-project van het bedrijf.
- De sleutel lekt. Google zegt het zelf: zet een sleutel nooit in code die bij de gebruiker draait en commit hem nooit in Git. Gebruik een backend en een secret manager, en zet budgetwaarschuwingen aan.
- Buiten de EER gelden andere dataregels. Werkt een collega of leverancier vanuit een ander land met dezelfde opzet, controleer dan welke voorwaarden daar gelden.
AI Studio of Agent Platform
Voor de meeste teams volstaat een betaalde sleutel uit AI Studio. Heb je strengere eisen, zoals een vaste regio voor je data of zero data retention, dan is er Gemini Enterprise Agent Platform, de opvolger van Vertex AI. Daar gebruikt Google je data niet om modellen te trainen zonder toestemming. Zero data retention vereist specifieke instellingen en geschikte functies; bij Grounding met Google Search en Google Maps kun je de bijbehorende opslag niet uitschakelen. Let wel: met het globale endpoint kunnen aanvragen vanuit elke regio worden verwerkt; voor dataresidentie kies je een regionaal endpoint.
Wat dit voor een team betekent
Een API-sleutel geeft toegang tot een model, niet tot kennis. Elke aanvraag begint bij wat jouw code meestuurt; wat de ene toepassing leert, weet de volgende niet. Bouw je meerdere agents op de Gemini API, naast Claude Code of Cursor bij de ontwikkelaars, dan heeft elk zijn eigen context. Lees ook Wat is context engineering? en Is Claude Code veilig voor bedrijfscode? voor dezelfde vraag bij een andere tool.
Waar Bombos past
Een sleutel regelt het model; Bombos regelt wat je agents weten. Het is een plugin die elke AI-tool en eigen agent van je team één gedeeld geheugen geeft, met teamkennis, regels die uit correcties geleerd zijn en wat er al ligt in mail, documenten en repo’s. Het is een context graph met retrieval, geen eigen model, dus je ziet waarop een antwoord rust. In de cloud of standalone op je eigen server met je eigen modellen, en één ontwikkelaar kan het eerst proberen voor zijn eigen agents.
Vragen die hierbij horen
Welke omgevingsvariabele gebruik ik voor de sleutel?
GEMINI_API_KEY of GOOGLE_API_KEY. Staan ze allebei ingesteld, dan gaat GOOGLE_API_KEY voor.
Wat zijn auth keys?
Sinds 28 mei 2026 is elke nieuwe sleutel in AI Studio een authorization key: hij is gekoppeld aan een serviceaccount van Google Cloud, zodat aanvragen onder die identiteit lopen, en standaard beperkt tot de Gemini API.
Wat kost de Gemini API?
Dat verschilt per model. Gemini 4 Argon kost op de betaalde laag $2 per miljoen inputtokens en $10 per miljoen outputtokens tot en met 30 november 2026, daarna $4 en $20. Argon zit niet in de kosteloze laag.
Mag ik de kosteloze laag gebruiken voor een app voor klanten in Nederland?
Nee. Volgens de voorwaarden mag je voor API-toepassingen die je beschikbaar maakt voor gebruikers in de EER alleen betaalde diensten gebruiken.
