Gemini API-sleutel aanvragen

Om gebruik te maken van de AI Assistent in het MODx-CMS, zul je over een Gemini API-sleutel moeten beschikken. Dit is een unieke code die fungeert als jouw persoonlijke toegangspas om Gemini AI via een extern programma (het MODx CMS) te kunnen aansturen. Met een gratis of betaald Google-Account kun je deze sleutel aanmaken via de volgende stappen: 

1. Ga naar Google AI Studio
   Open je webbrowser en navigeer naar aistudio.google.com. Log hier in met je bestaande Google-account (bijvoorbeeld je Gmail-adres of Google Workspace-account). 
   
   
2. Accepteer de voorwaarden
   Als dit de eerste keer is dat je Google AI Studio bezoekt, krijg je een welkomstscherm te zien. Vink het akkoord-vakje aan om de servicevoorwaarden te accepteren en klik op Continue (Doorgaan). 
   
   
3. Navigeer naar API-sleutels
   Kijk onderaan in het menu aan de linkerkant van je scherm. Klik op het menu-item Get API key (te herkennen aan het sleutel-icoontje). 
   
   
4. Maak een nieuwe sleutel aan
   Klik rechts boven in het hoofdscherm op de knop met de tekst Create API key. 
   
   
5. Kies een project
   Er verschijnt een klein pop-up venster. Kies voor een new project en verzin een toepasselijke naam voor de API-sleutel, bijvoorbeeld MODx AI Assistent. Klik op de knop Create key. Google zal nu op de achtergrond automatisch een nieuw (gratis) project voor je aanmaken en een API-sleutel voor je aanmaken. Dit duurt een paar seconden. 
   
   
6. Kopieer je API-sleutel
   Zodra de sleutel is gegenereerd, verschijnt deze op je scherm. Dit is een lange reeks van letters, cijfers en tekens. Klik op de knop Copy ernaast om de sleutel naar je klembord te kopiëren. 

Geef deze API-sleutel door aan je webbouwer, zodat zij deze kunnen instellen in je MODx CMS.

Belangrijk

Behandel je API-sleutel net als een wachtwoord. Deel deze nooit openbaar op internet of met partijen die je niet kent, aangezien de sleutel direct aan jouw (bedrijfs-)account gekoppeld is. 

Gebruikslimieten (Rate Limits)
Bij het gratis account van Google AI Studio ben je gebonden aan de volgende limieten:

• Maximaal 10 verzoeken per minuut (RPM).
• Maximaal 250 verzoeken per dag (RPD).

Voor een individuele redacteur of een gemiddelde website is dit vaak ruim voldoende. Als de plugin echter door meerdere gebruikers tegelijk of zeer intensief gebruikt wordt, kun je tegen deze limieten aanlopen. Vanaf dat moment zou je over moeten stappen op een betaald (Pay-as-you-go) account.

Privacy en Data
De belangrijkste eis bij het gebruik van de gratis API ("Free Tier") is dat Google de data die je naar de API stuurt (zoals pagina-inhoud, concepten en prompts) mag gebruiken en opslaan om hun eigen producten en AI-modellen te trainen en verbeteren. De kans is groot dat je website deze inforatie toch al openbaar deelt, maar ben je hiervan bewust als dat niet het geval is.

Over het algemeen geldt: Laat AI geen watchtwoorden, persoonsgegeven en vertrouwelijke bedrijfsgegevens verwerken als je van de gratis API-versie gebruik maakt. Bij een betaald account vervalt deze eis en traint Google niet op jouw API-data.