Source: https://ailoot.ai/docs/nl-be/how-it-works/
Canonical: https://ailoot.ai/docs/nl-be/how-it-works/
Language: nl-be

[Aan de slag](https://ailoot.ai/docs/nl-be/) 

# Zo werkt het

[Markdown](https://ailoot.ai/docs/nl-be/how-it-works/index.md)

Wat er met een verzoek gebeurt tussen je programma en het model.

Je verstuurt een verzoek naar Ailoot API zoals je het rechtstreeks naar OpenAI, Anthropic of Google zou sturen. Ailoot controleert de sleutel en het saldo, geeft het verzoek aan het model door, retourneert het antwoord in hetzelfde formaat en schrijft de kosten op basis van het daadwerkelijke verbruik af.

<em>01</em><strong>Verzoek</strong>Je client verstuurt het verzoek naar api.ailoot.ai met sleutel sk-…

<em>02</em><strong>Validatie en reservering</strong>Sleutel, limieten en saldo. Tijdens het voorbereiden van het antwoord wordt een bedrag gereserveerd.

<em>03</em><strong>Model</strong>Het model antwoordt en het antwoord komt terug in jouw formaat.

<em>04</em><strong>Afschrijving</strong>Eén afschrijving op basis van de daadwerkelijke tokens; het resterende gereserveerde bedrag wordt vrijgegeven.

## [](https://ailoot.ai/docs/nl-be/how-it-works/#formats)Eén sleutel — drie formaten

Het formaat wordt door het verzoekpad bepaald, niet door het model. Je kunt hetzelfde Claude-model via OpenAI Chat, OpenAI Responses of Anthropic Messages aanroepen — het antwoord volgt het formaat van het aangeroepen pad.

| Formaat | Pad | Wie het gebruikt |
| --- | --- | --- |
| OpenAI Chat Completions | `/v1/chat/completions` | OpenAI SDK, de meeste chats en editors, n8n, LangChain |
| OpenAI Responses | `/v1/responses` | Codex CLI, OpenAI Agents SDK, nieuwere SDK-versies |
| Anthropic Messages | `/v1/messages` | Claude Code, Anthropic SDK, Zed, Cline |
| Gemini | `/v1beta/models/{model}:generateContent` | Gemini CLI, Google GenAI SDK |

## [](https://ailoot.ai/docs/nl-be/how-it-works/#money)Geldzaken: reservering en één afschrijving

- Vóór de verzending van een nieuw tekstverzoek reserveert Ailoot een geschat bedrag voor de invoer en een typisch antwoord, rekening houdend met de limiet (`max_tokens`) en de voorwaarden van het specifieke model. Past de reservering niet binnen het vrije saldo of de sleutellimiet, dan mag de meegestuurde limiet alleen worden verlaagd voor een model en methode die deze daadwerkelijk naleven. Daarbij moet de limiet minstens 256 tokens bedragen en ook aan het vastgelegde minimum voor het antwoord voldoen. Voor afbeeldingen, video en audio als uitvoer blijven de volledige kosten van het resultaat gereserveerd.
- Na het antwoord volgt één afschrijving voor het daadwerkelijke verbruik. De ongebruikte reservering wordt direct aan het saldo teruggegeven.
- Is het antwoord duurder dan de reservering, dan wordt het verschil van het vrije saldo afgeschreven. Het saldo wordt nooit negatief.
- Als er onvoldoende saldo is voor zelfs de minimale reservering, wordt het verzoek niet verstuurd: je krijgt een duidelijke fout 402 en er wordt niets afgeschreven.
- Een fout zonder resultaat wordt niet in rekening gebracht.

Meer informatie en een rekenvoorbeeld staan op de pagina [Reservering en afschrijving](https://ailoot.ai/docs/nl-be/billing/reserve/).

## [](https://ailoot.ai/docs/nl-be/how-it-works/#errors)Fouten met een Request ID

Elk antwoord krijgt een verzoek-ID: in de header `X-Request-ID` en in de foutmelding. Fouten komen in het JSON-formaat van de aangeroepen API, zodat SDK’s ze herkennen. Als er iets misgaat, stuur de Request ID dan naar [support](https://ailoot.ai/docs/nl-be/support/) — zo vinden we het verzoek binnen een minuut terug.

401 Unauthorized

```json
{
  "code": "API_KEY_REQUIRED",
  "error": {
    "code": "invalid_api_key",
    "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer <key>\". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.",
    "param": null,
    "reason": "invalid_api_key",
    "request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6",
    "type": "invalid_request_error"
  },
  "message": "No API key was sent with the request. Nothing was charged. …"
}
```

## [](https://ailoot.ai/docs/nl-be/how-it-works/#streaming)Streams en timeouts

Gestreamde antwoorden (`stream: true`) gebruiken Server-Sent Events. Ailoot levert het betaalde tekstantwoord na de kostenberekening. Met `stream: true` blijft het formaat dus gestreamd (SSE), maar komt de tekst als één blok binnen wanneer het model klaar is, niet woord voor woord. Duurt het voorbereiden van het antwoord langer dan ongeveer 15 seconden, dan sturen Chat Completions-, Responses- en Messages-streams eerst statusregels `: ping` (ongeveer elke 10 seconden), daarna de regel `: ailoot-charged-usd …` met het afgeschreven bedrag en de gegevens zelf. SDK’s slaan zulke regels over.

Het Gemini-formaat bevat geen statusregels: het antwoord van `:streamGenerateContent` komt na de berekening in zijn geheel binnen. Houd voor redeneermodellen voldoende marge in de clienttimeout: meerdere minuten is normaal.

## [](https://ailoot.ai/docs/nl-be/how-it-works/#headers)Antwoordheaders

`X-Request-ID` wordt met elk antwoord meegestuurd. De andere headers voegt Ailoot aan betaalde tekstantwoorden toe:

| Header | Inhoud |
| --- | --- |
| `X-Request-ID` | Verzoek-ID — support vraagt hierom |
| `X-Ailoot-Charged-USD` | Het voor dit verzoek afgeschreven bedrag in dollars |
| `X-Ailoot-Output-Tokens` | Het aantal betaalde antwoordtokens |
| `X-Ailoot-Max-Tokens-Capped` | De verlaagde antwoordlimiet omdat het saldo onvoldoende was voor de volledige reservering |
| `X-Ailoot-Notice-Code`, `X-Ailoot-Notice` | Uitleg wanneer het antwoord de lengtelimiet heeft bereikt |

Als de stream al met statusregels is begonnen, komen deze gegevens vóór de data in een commentaarregel, niet in een header.

## [](https://ailoot.ai/docs/nl-be/how-it-works/#cache)Promptcache

Als het model caching ondersteunt, kan een opnieuw verstuurd lang voorvoegsel (systeeminstructie, documenten) goedkoper zijn. De prijzen voor cachelezen en -schrijven staan op de modelkaart in de [catalogus](https://ailoot.ai/models/nl-be/). De ontwikkelaar van het model bepaalt of er een cachehit is; Ailoot garandeert die niet.

Nog vragen? Stuur de Request ID en een beschrijving — we helpen je verder.[Contact opnemen met support](mailto:support@ailoot.ai)

## Ailoot · Het bedrijf en zijn projectenportefeuille





Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle.





Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.





Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.