ガイド
出力形式
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 フィールドが付随します。単一ページの呼び出しではアカウントの利用履歴を確認してください。
- 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
レガシーの真偽値と include
古いリクエストでは includeHtml: true と extractLinks: true が使われていました。両方とも引き続き動作しますが、新しいコードでは formats（および metadata / html 用の include）を推奨します —— 組み合わせ可能で、コードレビューでも明確です。