Formatos de salida
Markdown, JSON estructurado, metadatos, HTML, enlaces, imágenes, resumen, pregunta/respuesta, highlights
Thunderbit puede devolver cualquier combinación de los formatos siguientes. Usa el array formats en /distill, /extract y /search para añadir cualquier cosa más allá del predeterminado. El array legacy include sigue soportado para metadata / html.
Formatos disponibles
| Formato | Cómo solicitarlo | Devuelto como | Notas |
|---|---|---|---|
| Markdown | formats: ["markdown"] (predeterminado en /distill) | data.markdown | Gratis — incluido por defecto. |
| JSON estructurado | Predeterminado en /extract; aporta un schema o deja que Thunderbit lo auto-genere | data.data | El schema es opcional desde 2026-05-19. |
| Metadatos | include: ["metadata"] | data.metadata | Gratis. Disponible en /distill. |
| HTML original | include: ["html"] | data.html | Úsalo con moderación — payloads grandes. |
| Enlaces | formats: ["links"] | data.links (array de {text, href}) | Gratis. |
| Imágenes | formats: ["images"] | data.images (array de {src, alt, width, height}) | Gratis. |
| Resumen | formats: [{"type":"summary"}] | data.summary (Markdown) | +4 créditos al tener éxito. |
| Pregunta / Respuesta | formats: [{"type":"question","question":"…"}] | data.answer | +4 créditos al tener éxito. |
| Highlights | formats: [{"type":"highlights","query":"…"}] | data.highlights (array de strings) | +4 créditos al tener éxito. |
Combinar formatos
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 respuesta lleva cada clave solicitada en data — data.markdown, data.links, data.images, data.summary, data.answer, data.highlights. Las claves no solicitadas se omiten, no se devuelven como null.
Cálculo de créditos
Los formatos LLM (summary, question, highlights) solo se cobran cuando devuelven un resultado. La respuesta incluye un campo creditsUsed en respuestas batch y search; para llamadas a una sola página, revisa tu ledger de cuenta.
- Distill con un formato LLM → 1 + 4 = 5 credits
- Distill con tres formatos LLM → 1 + 3×4 = 13 credits
- Extract con un formato LLM → 20 + 4 = 24 credits
- Search con
limit: 5ysummary→ 5 × (1 + 4) + 1 = 26 credits
Booleanos legacy e include
Las solicitudes antiguas usaban includeHtml: true y extractLinks: true. Ambas siguen funcionando; en código nuevo prefiere formats (y include para metadata / html) — son composables y más claros en la revisión de código.