De Claude API in je app integreren
Om de Claude API te integreren, maak je een API-sleutel aan in de Claude Console van Anthropic, bewaar je die als geheim op de server (meestal ANTHROPIC_API_KEY), en roep je de Messages API aan vanaf een route op je eigen server met een van de officiële SDK's van Anthropic. Elk verzoek noemt een model, stelt max_tokens in (het langste antwoord dat je accepteert) en stuurt het gesprek als messages, met je instructies in een aparte system-prompt. Stel een uitgavenlimiet in, stream lange antwoorden, en vang rate-limit-fouten (429) en overbelastingsfouten (529) op met nieuwe pogingen.
Deze gids behandelt de installatie, een veilige aanvraagstroom, prompts voor een AI-builder en de fouten waarmee je rekening moet houden. De details van Anthropic komen uit hun documentatie per september 2026. Voor hoe tokens en prijzen in het algemeen werken, zie hoe je LLM-API's gebruikt.
Wat je ermee kunt bouwen
- Chatassistenten en hulpwidgets (hoe je een AI-chatbotapp bouwt)
- Samenvattingen, herschrijvingen en concepten van antwoorden
- Velden halen uit documenten, e-mails en formulieren
- Vragen beantwoorden op basis van je eigen content
- Agents die functies van je app aanroepen via tool use
Voor meer ideeën, zie hoe je AI-functies aan je app toevoegt.
De Messages API kort samengevat
Volgens de API-referentie van Anthropic is een verzoek een POST naar https://api.anthropic.com/v1/messages met:
| Onderdeel | Wat het is |
|---|---|
x-api-key header | Je API-sleutel |
anthropic-version header | De API-versie, bijvoorbeeld 2023-06-01 |
model (verplicht) | Welk Claude-model je gebruikt |
max_tokens (verplicht) | Het maximale aantal tokens dat het antwoord mag bevatten; het model kan eerder stoppen |
messages (verplicht) | Het gesprek: afwisselende user- en assistant-beurten |
system (optioneel) | Instructies die voor het hele gesprek gelden |
stream (optioneel) | Zet op true om het antwoord te ontvangen terwijl het wordt geschreven, via server-sent events |
De API is stateless: om een gesprek voort te zetten, stuur je de eerdere beurten bij elk verzoek opnieuw mee. Daarom kosten lange chats meer per bericht.
Anthropic publiceert officiële SDK's voor Python, TypeScript, C#, Go, Java, PHP en Ruby. Ze zetten de headers, verwerken de antwoorden en ondersteunen streaming. Gebruik er een in plaats van ruwe HTTP, tenzij je een goede reden hebt om dat niet te doen.
Een model kiezen
Anthropic biedt verschillende Claude-modellen die capaciteit afwegen tegen snelheid en prijs, en het aanbod verandert. Kies het kleinste model dat je taak goed uitvoert, test het op echte voorbeelden, en bewaar de model-ID in de configuratie zodat je zonder codewijziging kunt wisselen. Bekijk de modellen- en prijspagina's van Anthropic voor de actuele opties en tarieven.
Je account instellen
- Log in op de Claude Console op platform.claude.com en voeg facturering toe.
- Maak een API-sleutel aan. Houd per omgeving (testen en productie) één sleutel aan, zodat je er één kunt intrekken zonder de andere te breken.
- Stel een uitgavenlimiet in. De foutenpagina van Anthropic vermeldt dat de API een 400-fout teruggeeft wanneer het gebruik de limiet bereikt die je hebt ingesteld, dus je app moet in dat geval een duidelijk bericht tonen.
- Bekijk de rate limits van je account in de Console; die worden per organisatie gemeten.
De aanvraagstroom
- De gebruiker handelt in je app: stuurt een bericht of klikt op "Samenvatten".
- De browser roept jouw serverroute aan, nooit rechtstreeks Anthropic.
- Je server controleert of de gebruiker is ingelogd en mag gebruiken, en past een limiet per gebruiker toe.
- Het bouwt het verzoek: een system-prompt met jouw regels, de invoer van de gebruiker en de gegevens die de taak nodig heeft uit je database.
- Het roept de Messages API aan met de sleutel uit de omgeving en een verstandige
max_tokens. - Het streamt het antwoord naar de browser en logt het tokenverbruik uit de respons.
Opties en afwegingen
| Beslissing | Eenvoudige keuze | Wanneer verder gaan |
|---|---|---|
| Streaming | Wachten op het volledige antwoord | Streamen voor chat en alles wat lang duurt; Anthropic raadt streaming of batches aan voor langlopende verzoeken |
| Uitvoerformaat | Platte tekst | Gestructureerde JSON-uitvoer wanneer je code velden moet lezen |
| Je data | Het relevante record meesturen | Retrieval over je content als er te veel is (wat RAG is) |
| Acties | Model schrijft alleen tekst | Tool use, waarbij het model je code vraagt een functie uit te voeren die je hebt gedefinieerd |
| Bulkwerk dat niet dringend is | Loopen over items | De Message Batches API, waarbij je indient en de resultaten opvraagt |
Prompts voor je AI-builder
Een eerste functie:
Voeg een paneel "Vraag over dit document" toe. Het roept een serverroute POST /api/ask aan die controleert of de gebruiker is ingelogd en eigenaar is van het document, en roept daarna de Claude Messages API aan met de officiële Anthropic SDK en het geheim ANTHROPIC_API_KEY. Lees de model-ID uit het geheim CLAUDE_MODEL. System-prompt: "Antwoord alleen op basis van het aangeleverde document. Als het antwoord er niet in staat, zeg dat dan." Stuur de documenttekst en de vraag, zet max_tokens op 800, stream het antwoord naar de pagina en laat de sleutel nooit in de browser zien.
Waarborgen en fouten:
Beperk elke gebruiker tot 20 vragen per uur, bijgehouden in de database. Log de input- en outputtokens van elk antwoord met de gebruikers-ID en de verzoek-ID. Bij fouten 429 of 529 probeer je opnieuw met exponentieel oplopende wachttijden, tot 3 keer, rekening houdend met een eventuele retry-after header, en toon je daarna "De assistent is bezet, probeer het zo dadelijk opnieuw." Meldt de API een fout voor een uitgavenlimiet, toon dan "AI-functies zijn gepauzeerd" en waarschuw de beheerder.
Fouten waarmee je rekening moet houden
Uit de foutdocumentatie van Anthropic, de fouten die je app echt tegenkomt:
| Code | Type | Wat je doet |
|---|---|---|
| 400 | invalid_request_error | Repareer het verzoek; ook teruggegeven wanneer je een uitgavenlimiet bereikt die je zelf hebt ingesteld |
| 401 | authentication_error | Controleer of de sleutel aanwezig, correct en niet ingetrokken is |
| 413 | request_too_large | Stuur minder; de Messages API accepteert maximaal 32 MB per verzoek |
| 429 | rate_limit_error | Wacht en probeer opnieuw, rekening houdend met retry-after |
| 500 | api_error | Probeer opnieuw met oplopende wachttijden; neem contact op met support met de verzoek-ID als het blijft aanhouden |
| 529 | overloaded_error | Tijdelijk hoog verkeer van alle gebruikers; wacht en probeer opnieuw |
De documentatie van Anthropic zegt dat de officiële SDK's tijdelijke fouten (verbindingsfouten, rate limits en 5xx-fouten) standaard twee keer automatisch opnieuw proberen met exponentieel oplopende wachttijden, en dat je dit kunt configureren. Elke respons bevat een request-id header; log die zodat support problemen kan traceren.
Veelgemaakte fouten
- De API vanuit de browser aanroepen. Je sleutel wordt openbaar. Ga altijd via je server. Zie hoe je API-sleutels veilig houdt.
- Vergeten dat
max_tokenseen plafond is, geen doel. Stel het in op wat de functie nodig heeft; te laag snijdt antwoorden af, te hoog riskeert lange, dure antwoorden. - Regels in het gebruikersbericht zetten. Vaste instructies horen in de
system-prompt; rechten horen in je code. - Het hele gesprek eindeloos meesturen. Kap oude beurten in of vat ze samen naarmate gesprekken groeien.
- Geen uitgavenlimiet of limiet per gebruiker.
- Een model-ID hardcoden. Modellen worden bijgewerkt en uitgefaseerd.
- De stopreden negeren. Als het antwoord stopte omdat het
max_tokensbereikte, laat je de gebruiker dat weten of verhoog je de limiet.
Checklist
- API-sleutel aangemaakt in de Claude Console en opgeslagen als geheim op de server
- Aparte sleutels voor testen en productie
- Uitgavenlimiet ingesteld; duidelijk bericht wanneer die is bereikt
- Alle verzoeken gaan via je server met rechtencontroles
- System-prompt bevat de regels; model-ID is configureerbaar
-
max_tokensingesteld per functie; lange antwoorden gestreamd - Limiet per gebruiker in je app
- 429 en 529 afgehandeld met wachttijden; request-ID's gelogd
- Vriendelijke foutstatus die de pagina niet breekt
- Getest met lege, zeer lange en vijandige invoer
De Claude API gebruiken in Mythex
In apps die je op Mythex bouwt, gebruiken Claude-functies je eigen Anthropic-sleutel en worden ze gefactureerd op je Anthropic-account, niet op Mythex-buildcredits. Dat staat los van de Mythex-agent die je code schrijft. Voeg ANTHROPIC_API_KEY toe als projectgeheim via /secrets, de projectinstellingen of de geheimenkaart in de chat, en beschrijf de functie daarna met prompts zoals hierboven. Publiceer opnieuw na het wijzigen van geheimen op een live app. Zie AI-functies toevoegen met je eigen API-sleutels voor een startprompt. Als je tussen providers kiest, behandelt hoe je de OpenAI API integreert hetzelfde voor OpenAI.
Veelgestelde vragen
Hoe krijg ik een Claude API-sleutel?
Log in op de Claude Console op platform.claude.com, stel de facturering in en maak een API-sleutel aan. Bewaar die als geheim op de server, conventioneel genoemd ANTHROPIC_API_KEY, en zet hem nooit in code die in de browser draait.
Wat heeft een verzoek aan de Claude API nodig?
Vanaf september 2026 noemt de referentie van de Messages API van Anthropic drie verplichte velden in de body: model, max_tokens en messages. Directe HTTP-aanroepen hebben ook de headers x-api-key en anthropic-version nodig; de officiële SDK's zetten die voor je.
Wat is een 529-fout van de Claude API?
De foutenpagina van Anthropic beschrijft 529 als overloaded_error: de API is tijdelijk overbelast door een hoge verkeersdrukte van alle gebruikers. Probeer het opnieuw met exponentieel oplopende wachttijden. De officiële SDK's proberen sommige tijdelijke fouten automatisch opnieuw.
Kan ik Claude gebruiken met code die voor de OpenAI SDK is geschreven?
Anthropic documenteert een compatibiliteitslaag voor de OpenAI SDK, zodat je Claude via de OpenAI SDK-interface kunt gebruiken. Voor nieuwe code geven de eigen SDK's toegang tot Claude-specifieke functies, dus die zijn meestal het betere startpunt.