Een AI-API is een koppeling waarmee je eigen software een AI-model gebruikt dat draait bij een aanbieder zoals OpenAI, Anthropic of Google. API staat voor application programming interface: een afgesproken vorm waarin twee programma's vragen en antwoorden uitwisselen. Je webshop stuurt de vraag van een klant via internet en krijgt het antwoord van het model terug. Je betaalt per gebruik en draait zelf geen servers voor het model.
Hoe werkt een verzoek?
Je applicatie stuurt een HTTP-verzoek met een geheime API-sleutel, die je account en de bijbehorende rekening aanwijst. Een minimaal verzoek aan de Messages API van Anthropic noemt het model, de maximale lengte van het antwoord in tokens en het gesprek tot nu toe:
1 curl https://api.anthropic.com/v1/messages \ 2 -H "x-api-key: $ANTHROPIC_API_KEY" \ 3 -H "anthropic-version: 2023-06-01" \ 4 -H "content-type: application/json" \ 5 -d '{"model": "claude-sonnet-5", "max_tokens": 1000, 6 "messages": [{"role": "user", "content": "Mag ik een artikel uit de uitverkoop retourneren?"}]}'
Het antwoord komt terug als JSON, met de gegenereerde tekst, de reden waarom het model stopte en het aantal invoer- en uitvoertokens, waarop de rekening is gebaseerd. De API van OpenAI werkt net zo, met de sleutel in een Authorization: Bearer-header. Officiële SDK's voor Python, TypeScript en andere talen regelen de headers, nieuwe pogingen en streaming, waarbij het antwoord in stukjes binnenkomt terwijl het wordt geschreven.
Wat kun je vragen?
- Tekst: er gaat een vraag of gesprek in en er komt een antwoord uit, zoals bij de Messages API van Anthropic, de Responses API van OpenAI en de Gemini API van Google.
- Acties: het model vraagt je software een functie uit te voeren, zoals een bestelling opzoeken (function calling).
- Embeddings: er gaat tekst in en er komt een reeks getallen uit die de betekenis vastlegt, voor zoeken en RAG. OpenAI biedt ze aan; Anthropic heeft geen eigen embeddingmodel en verwijst naar Voyage AI.
- Beeld, spraak en video: de API van OpenAI maakt ook afbeeldingen, zet audio om in tekst, leest tekst voor en maakt video.
Wat kost het?
Tekstmodellen worden per miljoen tokens gefactureerd, en uitvoer is duurder dan invoer. In september 2026 rekent Anthropic voor Claude Sonnet 5 $2 per miljoen invoertokens en $10 per miljoen uitvoertokens, en voor Claude Haiku 4.5 $1 en $5 (prijzen). OpenAI noemt voor transcriptie een prijs per minuut audio en voor video een prijs per seconde (prijzen). Beide aanbieders halveren de prijs voor verzoeken die kunnen wachten, via een batch-API.
Elk account heeft ook limieten. Anthropic telt verzoeken en invoer- en uitvoertokens per minuut; een verzoek boven de limiet krijgt foutcode 429, met een header die zegt hoe lang je moet wachten. De standaard gebruiksniveaus (tiers) hebben een maandelijks bestedingsplafond, in september 2026 $500 op het Start-niveau; is dat bereikt, dan mislukken verzoeken tot de volgende maand, tenzij je een niveau hoger gaat. Je kunt zelf een lagere limiet instellen (rate limits).
Waar gaat het mis?
- Wie je sleutel heeft, kan de API op jouw account gebruiken. Volgens de API-referentie van OpenAI mag de sleutel nooit in code aan de clientkant staan, zoals in een browser of app: hij hoort op je server.
- Je gegevens gaan de deur uit. OpenAI gebruikt API-gegevens sinds 1 maart 2023 niet voor training, tenzij je daar zelf voor kiest, en bewaart logbestanden voor misbruikcontrole standaard tot 30 dagen (gegevensbeheer). Volgens de documentatie van Anthropic (september 2026) worden bewaarde gegevens nooit zonder je uitdrukkelijke toestemming voor training gebruikt (gegevensbewaring).
- Modellen worden uitgefaseerd. Anthropic kondigt dat minstens 60 dagen vooraf aan, en daarna mislukken verzoeken aan het oude model; zo verdween Claude Opus 4.1 op 5 augustus 2026 van de Claude API (uitfasering).
- Elke aanbieder heeft zijn eigen formaat, dus overstappen betekent code aanpassen. Ollama, waarmee je open modellen op je eigen computer draait, accepteert een deel van het formaat van OpenAI.
Voorbeeld
Stel: een webshop wil bij elke klantmail een voorstel voor een antwoord. De server stuurt elke mail met het retourbeleid naar de API en toont het concept aan een medewerker, die het controleert en verstuurt. Bij 1.000 mails per maand van elk ongeveer 1.500 invoertokens en 300 uitvoertokens is dat 1,5 miljoen invoer- en 300.000 uitvoertokens: $3 plus $3 op Claude Sonnet 5 tegen de prijzen van september 2026, dus $6 per maand.
