Formats de sortie
Markdown, JSON structuré, métadonnées, HTML, liens, images, résumé, question/réponse, highlights
Thunderbit peut renvoyer n'importe quelle combinaison des formats ci-dessous. Utilise le tableau formats sur /distill, /extract et /search pour demander plus que ce qui est par défaut. Le tableau include hérité reste supporté pour metadata / html.
Formats disponibles
| Format | Comment le demander | Renvoyé sous | Notes |
|---|---|---|---|
| Markdown | formats: ["markdown"] (par défaut pour /distill) | data.markdown | Gratuit — inclus par défaut. |
| JSON structuré | Par défaut pour /extract ; fournis un schema ou laisse Thunderbit en générer un | data.data | Le schema est optionnel depuis 2026-05-19. |
| Métadonnées | include: ["metadata"] | data.metadata | Gratuit. Disponible sur /distill. |
| HTML d'origine | include: ["html"] | data.html | À utiliser avec parcimonie — payloads volumineux. |
| Liens | formats: ["links"] | data.links (tableau de {text, href}) | Gratuit. |
| Images | formats: ["images"] | data.images (tableau de {src, alt, width, height}) | Gratuit. |
| Résumé | formats: [{"type":"summary"}] | data.summary (Markdown) | +4 crédits en cas de succès. |
| Question / Réponse | formats: [{"type":"question","question":"…"}] | data.answer | +4 crédits en cas de succès. |
| Highlights | formats: [{"type":"highlights","query":"…"}] | data.highlights (tableau de chaînes) | +4 crédits en cas de succès. |
Combiner les formats
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"}
]
}'La réponse porte chaque clé demandée dans data — data.markdown, data.links, data.images, data.summary, data.answer, data.highlights. Les clés non demandées sont omises, pas mises à null.
Calcul des crédits
Les formats LLM (summary, question, highlights) ne sont facturés que lorsqu'ils renvoient un résultat. La réponse contient un champ creditsUsed dans les réponses batch et search ; pour les appels page unique, consulte le ledger de ton compte.
- Distill avec un format LLM → 1 + 4 = 5 credits
- Distill avec trois formats LLM → 1 + 3×4 = 13 credits
- Extract avec un format LLM → 20 + 4 = 24 credits
- Search avec
limit: 5etsummary→ 5 × (1 + 4) + 1 = 26 credits
Booléens hérités et include
Les anciennes requêtes utilisaient includeHtml: true et extractLinks: true. Les deux fonctionnent encore ; dans le nouveau code, préfère formats (et include pour metadata / html) — c'est composable et plus clair en revue de code.