Outputformaten
Markdown, gestructureerde JSON, metadata, HTML, links, afbeeldingen, samenvatting, vraag/antwoord, highlights
Thunderbit kan elke combinatie van onderstaande formaten teruggeven. Gebruik de formats-array op /distill, /extract en /search om meer dan de standaard te vragen. De legacy include-array blijft ondersteund voor metadata / html.
Beschikbare formaten
| Formaat | Hoe op te vragen | Teruggegeven als | Opmerkingen |
|---|---|---|---|
| Markdown | formats: ["markdown"] (standaard voor /distill) | data.markdown | Gratis — standaard inbegrepen. |
| Gestructureerde JSON | Standaard voor /extract; geef een schema op of laat Thunderbit er een auto-genereren | data.data | Schema is sinds 2026-05-19 optioneel. |
| Metadata | include: ["metadata"] | data.metadata | Gratis. Beschikbaar op /distill. |
| Originele HTML | include: ["html"] | data.html | Spaarzaam gebruiken — grote payloads. |
| Links | formats: ["links"] | data.links (array van {text, href}) | Gratis. |
| Afbeeldingen | formats: ["images"] | data.images (array van {src, alt, width, height}) | Gratis. |
| Samenvatting | formats: [{"type":"summary"}] | data.summary (Markdown) | +4 credits bij succes. |
| Vraag / Antwoord | formats: [{"type":"question","question":"…"}] | data.answer | +4 credits bij succes. |
| Highlights | formats: [{"type":"highlights","query":"…"}] | data.highlights (array van strings) | +4 credits bij succes. |
Formaten combineren
curl -X POST https://openapi.thunderbit.co/openapi/v1/distill \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/article",
"formats": [
"markdown",
"links",
"images",
{"type": "summary"},
{"type": "question", "question": "What is this page about?"},
{"type": "highlights", "query": "key takeaways"}
]
}'De response bevat elke gevraagde sleutel in data — data.markdown, data.links, data.images, data.summary, data.answer, data.highlights. Niet-gevraagde sleutels worden weggelaten, niet op null gezet.
Credit-berekening
LLM-formaten (summary, question, highlights) worden alleen in rekening gebracht als ze een resultaat opleveren. In batch- en search-responses staat een creditsUsed-veld; voor single-page calls zie je het in je account-ledger.
- Distill met één LLM-formaat → 1 + 4 = 5 credits
- Distill met drie LLM-formaten → 1 + 3×4 = 13 credits
- Extract met één LLM-formaat → 20 + 4 = 24 credits
- Search met
limit: 5ensummary→ 5 × (1 + 4) + 1 = 26 credits
Legacy-booleans en include
Oudere requests gebruikten includeHtml: true en extractLinks: true. Beide werken nog; in nieuwe code geef je de voorkeur aan formats (en include voor metadata / html) — composeerbaar en duidelijker in code review.