가이드
출력 형식
Markdown, 구조화 JSON, 메타데이터, HTML, 링크, 이미지, 요약, 질문/답변, 하이라이트
Thunderbit는 아래 형식들의 어떤 조합이든 반환할 수 있습니다. 기본값 외에 더 요청하려면 /distill, /extract, /search에서 formats 배열을 사용하세요. 레거시 include 배열은 metadata / html 용도로 계속 지원됩니다.
사용 가능한 형식
| 형식 | 요청 방법 | 반환 위치 | 비고 |
|---|---|---|---|
| Markdown | formats: ["markdown"] (/distill의 기본값) | data.markdown | 무료 —— 기본 포함. |
| 구조화 JSON | /extract의 기본값. schema를 제공하거나 Thunderbit가 자동 생성하도록 둠 | data.data | Schema는 2026-05-19부터 선택사항. |
| 메타데이터 | include: ["metadata"] | data.metadata | 무료. /distill에서 사용 가능. |
| 원본 HTML | include: ["html"] | data.html | 신중히 사용 —— 페이로드가 큼. |
| 링크 | formats: ["links"] | data.links ({text, href} 배열) | 무료. |
| 이미지 | formats: ["images"] | data.images ({src, alt, width, height} 배열) | 무료. |
| 요약 | formats: [{"type":"summary"}] | data.summary (Markdown) | 성공 시 +4 크레딧. |
| 질문 / 답변 | formats: [{"type":"question","question":"…"}] | data.answer | 성공 시 +4 크레딧. |
| 하이라이트 | formats: [{"type":"highlights","query":"…"}] | data.highlights (문자열 배열) | 성공 시 +4 크레딧. |
형식 조합
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"}
]
}'응답은 data 안에 요청한 각 키를 담습니다 —— data.markdown, data.links, data.images, data.summary, data.answer, data.highlights. 요청하지 않은 키는 null이 아니라 생략됩니다.
크레딧 계산
LLM 형식(summary, question, highlights)은 결과를 반환한 경우에만 과금됩니다. batch와 search 응답에는 creditsUsed 필드가 함께 들어 있습니다. 단일 페이지 호출은 계정 ledger에서 확인하세요.
- LLM 형식 1개로 Distill → 1 + 4 = 5 credits
- LLM 형식 3개로 Distill → 1 + 3×4 = 13 credits
- LLM 형식 1개로 Extract → 20 + 4 = 24 credits
limit: 5와summary로 Search → 5 × (1 + 4) + 1 = 26 credits
레거시 boolean과 include
이전 요청은 includeHtml: true와 extractLinks: true를 사용했습니다. 둘 다 여전히 동작하지만 새 코드에서는 formats(그리고 metadata / html용 include)를 권장합니다 —— 조합 가능하고 코드 리뷰에서 더 명확합니다.