Gevorderd · Bouwen met AI · module 144 van 155
Werken met een AI-API: sleutels, limieten en kosten
Roep een AI-model aan vanuit je eigen toepassing, met veilige sleutels, grenzen aan het gebruik en zicht op de kosten.
Na deze les
Je bewaart API-sleutels veilig, stelt grenzen in aan gebruik en kosten, en gaat zorgvuldig om met fouten en gegevens.
In beeld · Stap voor stap
Een AI-API veilig en betaalbaar gebruiken
Op de server, een eigen sleutel per toepassing, en meteen intrekken bij een lek.
Een budget met waarschuwing, een limiet per gebruiker en een maximale lengte.
Beperkt opnieuw proberen, een vaste modelversie en alleen nodige gegevens.
Onderdeel 1 van 3 · Sleutel als geheim
Je voorkeur voor minder beweging staat aan. Kies zelf elk onderdeel.
Een sleutel is als een bankkaart
Wie een AI-model aanroept vanuit een eigen toepassing, gebruikt een API: een technische ingang met een sleutel. Elke aanroep met die sleutel kost geld. Bewaar de sleutel daarom als een geheim op de server, nooit in de code van een webpagina, een app of een gedeeld document (les 143). Geef elke toepassing een eigen sleutel met alleen de nodige rechten, en vervang een sleutel meteen als ze uitgelekt kan zijn.
Grenzen aan gebruik en kosten
Stel bij de aanbieder een maandbudget of een waarschuwing in, als dat kan. Beperk in je toepassing hoeveel vragen een gebruiker per dag mag stellen en hoe lang invoer en antwoord mogen zijn (les 31 en 80). Een langere invoer en een groter model kosten meer per vraag. Reken vooraf: aantal gebruikers maal vragen per dag maal kost per vraag. Meet daarna het echte gebruik en vergelijk het met je schatting.
Fouten en gegevens zorgvuldig behandelen
Een API kan tijdelijk niet antwoorden of een limiet melden. Probeer dan een beperkt aantal keren opnieuw, met steeds een langere pauze, en toon de gebruiker een duidelijke melding (les 91). Leg vast welke modelversie je gebruikt, zodat het gedrag niet ongemerkt verandert (les 128). Lees de voorwaarden van de aanbieder: wat gebeurt er met de gegevens die je doorstuurt, en hoe lang worden ze bewaard? Stuur alleen door wat nodig is, en log geen volledige gesprekken met persoonsgegevens.
Nieuw oefenvoorbeeld
Van uitleg naar een bruikbaar resultaat.
Een API-sleutel is een geheim dat geld kost. Bewaar hem op de server, stel grenzen in en reken de kosten vooraf na.
Fictieve oefensituatieFictief: een vereniging bouwt een assistent die nieuwsbrieven samenvat. De ontwikkelaar zet de API-sleutel in de JavaScript van de website, zodat de assistent rechtstreeks vanuit de browser werkt.
Bekijk een mogelijke uitwerking
Zo kan het
De sleutel moet weg uit de browsercode: iedereen kan hem daar lezen en op kosten van de vereniging gebruiken. De browser stuurt de vraag naar een eigen server, die de sleutel als geheim bewaart, een limiet per bezoeker toepast en het model aanroept. De oude sleutel wordt ingetrokken.
Waarom dit werkt
Alleen een server kan een sleutel geheim houden en grenzen afdwingen. Een sleutel die al zichtbaar was, beschouw je als uitgelekt.
Maak het iets moeilijker
Welke drie gegevens wil je per dag zien om de kosten van je toepassing te volgen, zonder persoonsgegevens te bewaren?
Extra oefenen, op jouw tempo. Je hoeft niets in te sturen. Dit telt niet mee als automatische beoordeling.
Jouw werkplek · leren door te proberen
Maak iets. Kijk wat er verandert.
Even de AI-verbinding controleren… Je kunt het geschreven voorbeeld al bekijken.
Stel je opdracht voor aan Ende.
Lees het antwoord, verander één ding en vergelijk.
Eerder vastgehouden
Nieuwe versie
Jij houdt de controle
Wat wil je in je volgende poging verbeteren?
Alleen op dit apparaat. AI-antwoorden blijven alleen in dit paginageheugen. Dit is zelfcontrole, geen cijfer.
Waarom deze aanpak werkt
Alleen een server kan een sleutel geheim houden en grenzen afdwingen. Een sleutel die al zichtbaar was, beschouw je als uitgelekt.
Een stap verder
Welke drie gegevens wil je per dag zien om de kosten van je toepassing te volgen, zonder persoonsgegevens te bewaren?
Probeer & ontdek · vrijblijvend
Reken tokens en fictieve kosten per vraag
Maak de invoer langer en reserveer meer ruimte voor het antwoord. Hoe veranderen de fictieve kosten per vraag?
Blauw: invoerGroen: antwoordruimteGrijs: vrije ruimte
De opgegeven invoer en gereserveerde uitvoer passen samen in dit venster.
Oefenmodel, geen echte tokenizer of productlimiet. Invoer omvat ook instructies en geschiedenis. Fictief tarief: € 0,002 per 1.000 invoertokens en € 0,006 per 1.000 uitvoertokens. Werkelijke tarieven en rekenregels verschillen.
Deze proef werkt lokaal met fictieve gegevens en telt niet mee voor je lesafronding. Bij een nieuwe les of herladen begint ze opnieuw.
Een prompt om mee te starten
Help me de kosten schatten voor een fictieve toepassing die AI gebruikt om vragen van leden te beantwoorden. Aannames: 200 leden, gemiddeld 2 vragen per lid per week, ongeveer 1.500 tokens invoer en 400 tokens uitvoer per vraag. Gebruik fictieve tarieven per miljoen tokens die ik zelf invul: [tarief invoer] en [tarief uitvoer]. Toon de berekening per maand en stel twee grenzen voor die de kosten beperken.
Pas het toe
Een kleine webapp gebruikt een AI-API. Na een maand blijkt de rekening tien keer hoger dan verwacht: één gebruiker liet een script duizenden vragen per dag stellen.
Welke aanpak past het best bij deze situatie?
- Stel een limiet per gebruiker in en een maandbudget met waarschuwing, en ga na of de sleutel nog veilig is.
- De rekening betalen en hopen dat het niet opnieuw gebeurt.
- Overstappen naar een groter model, zodat de antwoorden beter zijn.
Met JavaScript kun je je aanpak controleren en direct feedback krijgen.
Test je inzicht
Je ontdekt dat je API-sleutel in een openbare codeopslag stond. Wat doe je eerst?
- De code uit de opslag verwijderen, dan is het opgelost.
- De sleutel meteen intrekken en een nieuwe aanmaken, en daarna het gebruik en de kosten nakijken.
- Afwachten of er ongewoon gebruik opduikt.
Extra oefenen
Maak voor een toepassing die je kent of bedenkt een kostenschatting per maand, en noteer drie grenzen: een maandbudget, een limiet per gebruiker en een maximale lengte van invoer en antwoord.
Gebruik: 200 leden × 2 vragen × ongeveer 4,3 weken = ongeveer 1.720 vragen per maand. Tokens: 1.720 × 1.500 = 2,58 miljoen invoertokens en 1.720 × 400 = 0,69 miljoen uitvoertokens. Met mijn fictieve tarieven kost dat enkele euro’s per maand. Grenzen: een maandbudget met waarschuwing bij 80%, maximaal 10 vragen per lid per dag en antwoorden van maximaal 400 tokens. De sleutel staat als geheim op de server.
