Claude Haiku 5.5 in de API: overstappen van Haiku 4.5

Haiku is het model dat je inzet als je duizenden kleine taken per dag door Claude wilt halen: tickets labelen, documenten samenvatten, klantvragen beantwoorden. Haiku 5.5 maakt dat een stuk goedkoper, maar wie gewoon de modelnaam in zijn code vervangt, krijgt foutmeldingen terug. Hieronder zet je een Haiku 4.5-aanroep in vier stappen om en reken je uit wat je echt bespaart.

Wat Haiku 5.5 anders maakt

In de API heet het model claude-haiku-5-5: een vaste naam zonder datum en zonder aparte alias. Het heeft een contextvenster van 1 miljoen tokens, geeft maximaal 128.000 tokens per antwoord terug en leest tekst en afbeeldingen (Bron: Claude-docs). Je gebruikt het via de Claude API, Amazon Bedrock (anthropic.claude-haiku-5-5), Google Cloud en Microsoft Foundry.

Anthropic noemt het zijn goedkoopste en snelste kleine model, bedoeld voor veel herhaalbaar werk: samenvattingen, classificatie, databasevragen en live klantenservice. Voor complexe programmeertaken blijven Sonnet 5.5 en Opus 5.5 de betere keus (Bron: Anthropic). Wil je eerst weten welke Claude-modellen er zijn, lees dan wat Claude AI is en kan.

De overstap in vier stappen

1. Vervang de modelnaam. claude-haiku-4-5 of claude-haiku-4-5-20251001 wordt claude-haiku-5-5.
2. Ruil budget_tokens in voor effort. Een thinking-blok met {"type": "enabled", "budget_tokens": N} geeft een 400-fout. Gebruik {"type": "adaptive"} en stuur de diepgang met output_config.effort (Bron: migratiegids).
3. Haal de sampling-parameters weg. Een afwijkende temperature of top_p, of welke top_k dan ook, geeft een 400-fout. Stuur je bijvoorbeeld temperature: 0 mee voor voorspelbare labels, haal die regel dan weg en stuur het gedrag met je prompt.
4. Stop met prefill en verhoog max_tokens. Een vooraf ingevulde assistent-beurt wordt geweigerd, ook zonder thinking: eindig altijd met een gebruikersbeurt. Denktokens tellen mee voor max_tokens, en dezelfde tekst kost ongeveer 30% meer tokens dan op Haiku 4.5 (Bron: migratiegids). Een krap ingestelde limiet kapt je antwoord dus eerder af.

Zo ziet een minimale aanroep eruit:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 4096,
    "thinking": {"type": "adaptive"},
    "output_config": {"effort": "low"},
    "messages": [{"role": "user", "content": "Label dit klantbericht als vraag, klacht of bestelling: ..."}]
  }'

💡 Beginner-tip: lees je antwoordblokken uit op hun type, niet op hun positie. Haiku 5.5 stuurt standaard een leeg thinking-blok mee vóór de tekst. Wie blind het eerste blok pakt, krijgt een lege string terug.

Het juiste effort-niveau kiezen

Haiku 5.5 is het eerste Haiku-model met een effort-instelling. Je kiest uit low, medium, high, xhigh en max; medium is de standaard en geeft hetzelfde resultaat als de parameter weglaten (Bron: Claude-docs over effort).

Een praktische vuistregel: low voor labels, routering en korte samenvattingen, medium voor gewone vraag-en-antwoordtaken, en pas hoger als een test laat zien dat de kwaliteit tekortschiet. Meer denkwerk betekent meer uitvoertokens, en uitvoer is vijf keer zo duur als invoer.

Wat je echt bespaart

Tot 100.000 tokens per prompt betaal je 0,10 dollar per miljoen invoertokens en 0,50 dollar per miljoen uitvoertokens. Haiku 4.5 kostte 1 en 5 dollar. Boven de 100.000 tokens stijgt Haiku 5.5 naar 0,50 en 2,50 dollar. Gecachte invoer lezen kost 0,01 dollar per miljoen tokens (Bron: Anthropic).

Op de prijslijst is dat 90% minder, maar door de nieuwe tokenizer tel je meer tokens voor dezelfde tekst. Anthropic schat de besparing daarom op gemiddeld zo’n 75%. Meet het zelf: tel je prompts opnieuw met het model op claude-haiku-5-5 in plaats van oude tellingen te hergebruiken.

⚡ Gevorderden: werk niet direct nodig, zoals nachtelijke verwerking van tickets, gaat via de Batch API voor de helft van de prijs. Lange vaste systeemprompts cache je: een cache-write van vijf minuten kost 0,125 dollar per miljoen tokens. Wat caching verder oplevert, lees je in de kostengids van aiplatformmkb.nl.

Wantrouw aanbieders die Claude nog veel goedkoper beloven; waarom, lees je in goedkope AI-API’s als valstrik. Draai je via Azure, dan helpt Claude in Microsoft Foundry je op weg. Hoe Anthropic eerder Sonnet 5.5 goedkoper per taak maakte, lees je op hetlaatsteainieuws.nl.

Checklist: ben je klaar?

• Je code gebruikt claude-haiku-5-5 als modelnaam
• budget_tokens is vervangen door thinking: {"type": "adaptive"} plus een effort-niveau
• temperature, top_p en top_k staan niet meer in je aanroep
• Je berichten eindigen met een gebruikersbeurt, zonder prefill
• max_tokens is ruim genoeg voor denktokens plus 30% meer tekst-tokens
• Je leest antwoordblokken uit op type, niet op positie
• Je hebt een testset gedraaid op low en medium en de kosten vergeleken met Haiku 4.5

Bronnen

• Anthropic: Claude Haiku 5.5
• Claude-docs: Claude Haiku 5.5 overview
• Claude-docs: migreren naar Claude Haiku 5.5
• Claude-docs: effort