Claude Api Integreren In Je Eigen Applicatie

Claude API integreren in je eigen applicatie

Dit artikel beschrijft hoe je de Claude API (Anthropic) toevoegt aan je applicatie — bedoeld voor ontwikkelaars die een backend-service bouwen voor gestructureerde AI-interacties.

Vereisten

- Een Anthropic API-key (aan te vragen op console.anthropic.com) - Node.js 18+ of Python 3.9+ - `axios` of `fetch` voor HTTP-aanroepen (of `anthropic-sdk-python` v0.8+) - Basiskennis van REST API’s en JSON

Stappen

1. Kies je integratielaag Maak een aparte backend-service die prompts bouwt, authenticatie beheert en API-aanroepen naar Anthropic verzendt. Deze laag verwerkt antwoorden en stuurt resultaten door naar je applicatie. Directe frontend-calls naar Claude zijn onveilig — vermijd dit.

2. Authenticeer via API-key Stel je key in als omgevingsvariabele en gebruik deze in elke API-aanroep. Python: ```python import os from anthropic import Anthropic client = Anthropic(api_key=os.environ.get("ANTHROPIC_API_KEY")) ``` Node.js: ```javascript const { Anthropic } = require('@anthropic-ai/sdk'); const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY }); ```

3. Kies API-methode Gebruik de Messages API voor tekst/afbeeldingen (v2023-06-01). Bij streaming: voeg `stream: true` toe aan de request body. Token count? Gebruik de `/v1/messages/count_tokens` endpoint (vereist model ID en content).

4. Bouw je promptstructuur Splits de context in drie delen: - `system`: vaste instructies (rol, toon, harde regels) - `messages`: user-assistant interactie - `tools`: optionele tool definitions (JSON schema) Voorbeeld system-prompt: ```json { "role": "system", "content": "Je bent een documentanalist. Vat de tekst in maximaal 3 zinnen. Gebruik alleen Nederlands." } ```

5. Verstuur een API-aanroep Python (Messaging API, streaming uit): ```python response = client.messages.create( model="claude-3-5-sonnet-20241022", max_tokens=1024, system="Vat het document in 3 zinnen.", messages=[{"role": "user", "content": "Lange documenttekst hier..."}] ) print(response.content[0].text) ``` Node.js: ```javascript const message = await client.messages.create({ model: "claude-3-5-sonnet-20241022", max_tokens: 1024, system: "Vat het document in 3 zinnen.", messages: [{ role: "user", content: "Lange documenttekst hier..." }] }); console.log(message.content[0].text); ```

6. Implementeer post-processing Valideer output op formaat (JSON schema check), sla op in database of trigger vervolgacties. Gebruik try/catch voor foutafhandeling (HTTP 429 = rate limit, 401 = ongeldige key).

7. Voeg menselijke controlepunten toe Bij hoge risico-output (medisch, juridisch) voeg een bevestigingsstap toe in je backend voordat resultaten naar de gebruiker gaan.

8. Monitor prestaties Log wekelijks: tokenverbruik (via `/v1/messages/count_tokens`), foutpercentages (HTTP status codes), en gemiddelde response-tijd. Bij modelwijziging hertest je prompts opnieuw.

Verificatie

Test of de API werkt met een minimale call: Python: ```python response = client.messages.create( model="claude-3-5-sonnet-20241022", max_tokens=10, messages=[{"role": "user", "content": "Zeg 'OK'"}] ) assert "OK" in response.content[0].text ``` Node.js: ```javascript const msg = await client.messages.create({ model: "claude-3-5-sonnet-20241022", max_tokens: 10, messages: [{ role: "user", content: "Say 'OK'" }] }); console.log(msg.content[0].text); // Verwacht: "OK" ```

Veelgestelde problemen

1. Rate limiting (HTTP 429) Oorzaak: te veel requests per minuut. Oplossing: voeg exponential backoff toe in je code (bv. `axios-retry` of `tenacity`). Python: ```python import time, random def retry_with_backoff(func, max_retries=3): for i in range(max_retries): try: return func() except: if i == max_retries - 1: raise time.sleep(2 i + random.uniform(0, 1)) ```

2. Model herkent instructies niet Oorzaak: system-prompt te algemeen. Oplossing: verplaats specifieke instructies naar `messages[0].content` (user-roi) en houd system-prompt kort (< 200 tokens).

3. JSON output kapot Oorzaak: Claude sluit JSON niet af. Oplossing: zet `response_format: { type: "json_object" }` in de request body (vanaf model v2024-10-22). Valideer met `JSON.parse()` en fallback op retry.

De Claude API geeft je geavanceerde taalmodellen — maar elk model heeft eigen inzichten voor prompts die je pas ontdekt in productie.