AI API voor beginners: werking, kosten en eerste API-call

👁 117 keer gelezen

Een AI API geeft je directe toegang tot taalmodellen zoals GPT, Claude en Gemini vanuit software in plaats van via een chatvenster. Je verstuurt een verzoek met je API-sleutel, ontvangt een JSON-antwoord en betaalt per verbruikt token, meestal fracties van een eurocent per verzoek. Dit vormt de eerste stap om vanaf nul je eigen AI-agent te bouwen: hieronder vind je het complete stappenplan, actuele tarieven en een pakket met kant-en-klare scripts die zijn getest op Windows.

Stappenplan: van de basis naar een eigen AI-agent

Regelmatig krijg ik de vraag hoe een AI API precies onder de motorkap werkt, hoe je automatiseringen opzet en hoe je zelf een eenvoudige agent bouwt zonder simpelweg code over te typen. Dit leertraject bestaat uit drie fases waarin elke stap voortbouwt op de vorige:

Fase 2 en 3 zijn uitgewerkt in de gids AI-agents vanaf de basis. Achtergrondtheorie vind je in de artikelen over hoe LLM’s werken, MCP, RAG en fine-tuning.

Wat is een AI API?

Een API (Application Programming Interface) is een gestandaardiseerde manier waarop software communiceert met andere software. Bij AI stuurt je script via internet een verzoek met de modelnaam, je berichten en instellingen, waarna de server van de provider de gegenereerde tekst retourneert. Geen grafische chatinterface, geen bewaarde gespreksgeschiedenis, geen vast abonnement: je rekent enkel af op basis van het aantal tokens dat je instuurt en terugkrijgt.

Hieronder zie je de werkelijke aanroep die ik op 4 oktober 2026 heb uitgevoerd vanuit de Windows-terminal (in het oorspronkelijke experiment werd getest met een Poolse vraag, hier vertaald naar het Nederlands):

#!/usr/bin/env bash
# Eerste aanroep via curl (Git Bash, Linux, macOS). Vooraf: export OPENROUTER_API_KEY=sk-or-v1-...
curl -s https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-luna",
    "messages": [{"role": "user", "content": "Schrijf één zin over Krakau."}]
  }'

Het model GPT-6 Luna gaf een antwoord in één zin, verbruikte 16 input-tokens en 36 output-tokens, en OpenRouter bracht hiervoor circa € 0,0000175 (0,0000196 USD) in rekening. Een uitgebreide uitleg van requests, responses, JSON-structuren en statuscodes (401, 429, 500) vind je in het artikel Wat is een API? Uitleg aan de hand van AI.

Praktische toepassingen hiervan zijn onder meer:

• het automatisch samenvatten van e-mails, notities en documenten op de achtergrond;
• gestructureerde data extraheren uit facturen, cv’s of offertes rechtstreeks naar een database;
• een chatbot integreren op je eigen website of in een berichtendienst;
• het automatisch categoriseren van klantvragen en reviews;
• achtergrondscripts die ’s nachts draaien en elke ochtend een rapport klaarijden;
• autonome software-agents die zelf tools aanroepen (fase 3 van het traject).

Beginnen in 8 stappen

1. Begrijp requests en responses. Neem 15 minuten de tijd voor het artikel Wat is een API en voer je eerste curl-commando uit.
2. Maak een account en API-sleutel aan. Voor beginners raad ik OpenRouter aan (één sleutel voor honderden modellen) of Google AI Studio (gratis zonder betaalgegevens). Instructies voor meerdere providers vind je in API-sleutels: aanmaken en beveiligen.
3. Stel direct een uitgavenlimiet in. Een limiet van circa € 1,79 tot € 4,47 (2-5 USD) per maand is ruimschoots voldoende voor leerdoeleinden en voorkomt onverwachte kosten bij een eventueel datalek.
4. Installeer Python en doe je eerste API-call. Virtuele omgevingen (venv), de openai-bibliotheek, streaming en foutafhandeling worden behandeld in Je eerste AI API-aanroep in Python (inclusief Node.js-versie).
5. Bereken het verbruik vooraf. Zie het overzicht AI-tokens en API-kosten berekenen.
6. Beheers de parameters. System prompts, temperatuur, context windows en limieten worden experimenteel toegelicht in API-parameters helder uitgelegd.
7. Ontvang JSON in plaats van gewone tekst. Lees Structured output: AI dwingen te antwoorden in JSON; onmisbaar voor betrouwbare automatiseringen.
8. Kies je vaste provider. Bekijk OpenAI, Claude of Gemini API vergelijken en de gids over OpenRouter.

Modellen en providers

Iedere aanbieder heeft verschillende modelvarianten: van compact en razendsnel tot grootschalig en krachtig. Om te starten volstaat het om per segment één optie te kennen:

Specifieke achtergronden over individuele platformen vind je via Google AI Studio, DeepSeek, Mistral, Kimi, Grok API en de Agents API van OpenAI.

API-tarieven

Binnen API’s betaal je per miljoen tokens, gesplitst in input (invoer) en output (uitvoer). Prijzen per 4 oktober 2026, exclusief btw (indicatieve eurowaarde berekend via 1 EUR = 1,1181 USD):

* Uitgaande van een e-mailsamenvatting met 800 input-tokens en 150 output-tokens, 100 keer per dag gedurende 30 dagen. Meer details en een rekenmodule vind je in het artikel over AI-tokens en tarieven. Twee belangrijke aandachtspunten: reasoning-modellen tellen interne denkstappen mee als output-tokens (Gemini 3.8 Flash verbruikte bij mij bijvoorbeeld 390 ‘denktokens’ voor een antwoord van twee zinnen), en niet-Engelse talen verbruiken doorgaans meer tokens per woord dan Engels.

Taalverschillen in tokenverbruik

De grote taalmodellen ondersteunen meertalige invoer probleemloos. Wel verschilt de efficiëntie per taal door de werking van tokenizers. Tijdens een benchmarktest waarin we exact dezelfde alinea aan zeven modellen voorlegden in zowel het Pools als het Engels, leverde dat duidelijke verschillen op:

Let bij meertalige verwerking dus altijd op de reële kosten per aanroep via de API-respons (het veld usage.cost), en niet alleen op de basistarieven per miljoen tokens. Claude Sonnet 5.5 en GPT-6.1 Sol hanteren identieke tarieven per miljoen tokens, maar bij niet-Engelse teksten zoals in deze test verbruikte Claude ongeveer 1,7 keer zoveel tokens. De precieze meetmethode staat beschreven in het artikel over tokens.

De testomgeving en het scriptpakket

Alle codevoorbeelden uit deze handleiding zijn lokaal getest en tonen de werkelijke uitvoer. De testconfiguratie bestond uit Windows 11 Pro, Python 3.13.15 (met openai 3.24.0, pydantic 2.13.5, tiktoken 0.14.0), Node.js 26.10 (openai 7.27.0) en curl 8.22, met OpenRouter als gateway. De scripts zijn samengebracht in een downloadbaar archief met bijbehorende documentatie en een .env.example-sjabloon:

Download de scripts: api-starter-archief.zip

De inhoud van het pakket omvat:

• 01-03: Eerste aanroepen met realtime kostenberekening, streaming functionaliteit, automatische retries bij fouten en een mock-server die 429-fouten simuleert om foutafhandeling gratis te testen;
• 04: Temperatuurtests (0 / 0,7 / 1,2) en aandacht voor modellen zoals GPT-6 die deze parameter onder bepaalde omstandigheden negeren;
• 05: Structured output: factuurdata valideren via Pydantic-schema’s en gestructureerde sentimentanalyse;
• 06: Tokenisatie-analyse en metingen van taaloverhead over 7 modellen;
• 07: Werken met system prompts en het afkappen van responses via max_tokens;
• 08: Automatisch overzicht ophalen van actieve gratis modellen op OpenRouter;
• 09: Benchmark waarbij één vraag gelijktijdig naar 6 modellen gaat met latency- en kostenmeting;
• 10: Vergelijking van eenzelfde model over meerdere aanbieders op het gebied van prijs, responstijd en dataretentie;
• curl/, js/, dostawcy/: Terminalcommando’s, Node.js-varianten en directe implementaties voor OpenAI, Anthropic en Google Gemini.

Transparantie over de tests: de scripts in de map dostawcy/ zijn gecontroleerd op correcte interactie met de SDK’s via testcredentials (waarbij de servers de verwachte authenticatiefout teruggaven). Alle overige scripts zijn daadwerkelijk uitgevoerd tegen actieve productiemodellen. De totale kosten voor de volledige testreeks bleven ruim onder circa € 0,05 (5 dollarcent).

Opvallende observaties uit de experimenten:

• Bij temperatuur 0 gaf het model driemaal een exact identieke respons tot op het leesteken nauwkeurig; bij temperatuur 1,2 traden direct hallucinaties en afwijkende regelafbrekingen op;
• Eenzelfde testvraag voorgelegd aan zes modellen leverde verwerkingskosten op tussen circa € 0,000018 en € 0,00280 (0,00002 tot 0,00313 USD) - een factor 150 verschil bij vergelijkbare antwoordkwaliteit;
• Hetzelfde model (gpt-oss-120b) via vier verschillende hosters gaf responstijden tussen 0,4 en 6,2 seconden en een prijsverschil tot factor 5,6;
• De instructie “antwoord in JSON” zonder expliciet schemasysteem resulteerde geregeld in JSON omsloten door Markdown-codeblokken, waardoor standaard json.loads-parsers vastliepen.

API, webchat, lokaal model of no-code?

Wanneer een eigen lokale grafische kaart rendabeler wordt dan een API-dienst, lees je in het artikel Lokaal model of API. No-code tools vallen onder fase 2 van het traject: omdat deze onderhuids vrijwel altijd API-calls gebruiken, is de opgedane basiskennis direct toepasbaar.

Voor wie is deze gids bedoeld?

• Voor gebruikers van AI-chatbots die repeterende taken willen automatiseren zonder handmatig knippen en plakken.
• Voor softwareontwikkelaars die snel inzicht willen krijgen in tokenstructuren, parameters, kostenbeheer en structured output.
• Voor ondernemers en managers die een realistische inschatting willen maken van de operationele kosten van een chatbot of automatiseringsproject.
• Voor studenten die de techniek kosteloos willen verkennen via de beschikbare gratis tiers.

Uitgebreide programmeerkennis is niet vereist. Het volstaat om commando’s in een terminal te kunnen plakken en tekstparameters aan te passen. Wie liever volledig visueel begint, kan direct starten met Automatiseren met AI: het begin.

Veelgestelde vragen

Wat is een API precies?

Een API is een gestructureerde interface waarmee software met andere applicaties communiceert. Bij AI betekent dit dat je GPT- of Claude-modellen aanroept via code in plaats van via een interactieve website.

Wat kost het gebruik van een AI API?

Je betaalt per token: vanaf circa € 0,09 (0,10 USD) per miljoen input-tokens (GPT-6 Luna) tot circa € 44,72 (50 USD) per miljoen output-tokens voor zware redeneermodellen (GPT-6 Astra, Claude Fable 5.1). Een standaardaanroep bij een voordelig model kost doorgaans een fractie van een eurocent. Bereken je eigen situatie via de rekentool.

Is een AI API gratis te gebruiken?

Deels. Google biedt binnen de Gemini API een gratis laag voor Flash-modellen, en OpenRouter stelt 17 gratis modellen beschikbaar met een limiet van 50 verzoeken per dag. OpenAI hanteert geen gratis API-tier; Anthropic biedt af en toe een klein proeftegoed bij registratie.

Hoe kom ik aan een API-sleutel?

Maak een account aan op het gewenste ontwikkelaarsplatform (platform.openai.com, platform.claude.com, aistudio.google.com of openrouter.ai) en genereer een sleutel in het dashboard. Deze sleutel wordt om veiligheidsredenen slechts eenmalig getoond. Zie voor beveiligingstips de handleiding over API-sleutels.

Geeft een ChatGPT Plus-abonnement toegang tot de API?

Nee. Het consumentenabonnement op ChatGPT staat volledig los van het ontwikkelaarsplatform van OpenAI. Het API-platform werkt via een eigen pre-paid accountsysteem; hetzelfde geldt voor Claude en Gemini.

Wat is OpenRouter?

Een tussenpartij (aggregator) waarmee je met één centrale API-sleutel toegang krijgt tot meer dan 460 modellen van tientallen aanbieders. Je betaalt de reguliere API-tarieven van de providers, vermeerderd met een vaste opslag van 5,5% op opwaarderingen. Zie de gids over OpenRouter.

Moet ik kunnen programmeren om een API te benutten?

Niet noodzakelijk. Eenvoudige verzoeken voer je direct uit via curl of kant-en-klare scripts. Voor complexere verwerkingsketens is basiskennis van Python of een no-code platform (zoals n8n) wel aan te raden.

Welke programmeertaal is het meest geschikt voor AI API’s?

Python is de industriestandaard en heeft de meest uitgebreide documentatie en SDK-ondersteuning. JavaScript/TypeScript (Node.js) is een uitstekend alternatief, vooral bij webapplicaties of chatintegraties.

Bronnen en controle

Tarieven en documentatiespecificaties zijn gecontroleerd op 4 oktober 2026. De bijbehorende scripts zijn op dezelfde datum geverifieerd op Windows 11 via OpenRouter.

• OpenAI - API-tarieven
• Anthropic - API-tarieven
• Google - Gemini API-tarieven
• DeepSeek - Tarievenoverzicht
• xAI - Modellen en specificaties
• OpenRouter - Documentatie
• OpenRouter - Modelcatalogus
• openai-python - Officiële bibliotheek

// lees verderUtopai X: nummer 2 AI-videomodel, kosten en beginnenAI-toolsGoogle Flow: wat het is, kosten en hoe te beginnenAI-toolsBeslismodel in plaats van LLM: kosten voor 1 miljoen classificatiesHandleidingen

Kinetyra