Thunderbit Open API home page
支援API 主控台
Distill

批次蒸餾多個頁面

POST
/batch/distill
批次蒸餾多個頁面

透過非同步處理同時蒸餾多個網頁。

使用場景：

  • 處理整個網站板塊或分類
  • 批次匯入內容到知識庫
  • 大規模內容遷移
  • 定期從多個來源更新內容

工作原理：

  1. 提交最多 100 個 URL 的批次任務
  2. 立即取得任務 ID
  3. 輪詢狀態端點或接收 Webhook 通知
  4. 完成後取得所有結果

功能特性：

  • 非同步處理實現高吞吐量
  • 失敗自動重試
  • 完成時 Webhook 通知
  • 詳細的每 URL 狀態和錯誤報告

授權

YOUR_API_KEY
授權Bearer <token>

在 Thunderbit Dashboard 取得 API key。標頭格式：Authorization: Bearer YOUR_API_KEY

位置: header

請求體

application/json

TypeScript Definitions

Use the request body type in TypeScript.

urls*string[]必填

要蒸餾的 URL 列表，最多 100 個

範例：
[
  "https://example.com/page1",
  "https://example.com/page2",
  "https://example.com/page3"
]
timeoutnumber預設值：30000

每個請求的逾時時間（毫秒），預設 30000

取值範圍：5000 <= x <= 60000
countryCodestring預設值："US"

用於地理定位的 2 字母 ISO 國家碼，套用於每個 URL（預設 US）

範例：US
renderModestring預設值："none"

套用於每個 URL 的 JavaScript 渲染模式：none（預設）、basic 或 full

取值範圍"none" | "basic" | "full"
includeHtmlboolean預設值：false

是否為每個 URL 包含原始 HTML（預設 false）。建議改用 include 參數。

extractLinksboolean預設值：false

是否為每個 URL 提取連結（預設 false）。建議改用 include 參數。

includestring[]

每個 URL 可選包含的欄位。可選值：metadata、html、links。

範例：
[
  "metadata",
  "links"
]
webhookobject

Webhook 回呼配置，任務完成時通知。查看 Webhooks 指南 瞭解回呼負載、請求標頭和 HMAC-SHA256 簽章驗證。

展開子屬性
urlstring

Webhook callback URL, must be HTTPS

範例：https://your-server.com/api/webhook/distill
secretstring

HMAC-SHA256 secret for signature verification. When set, each webhook request includes an X-Webhook-Signature header

範例：whsec_your_secret_key
headersobject

Custom headers (reserved for future use, not yet implemented by the server).

範例：
{
  "X-Custom-Auth": "your-token"
}

回應

application/json

Success response

successboolean
範例：
true
dataobject
展開子屬性
idstring

批次任務 ID

範例：batch_abc123
statusstring
取值範圍"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
範例：PROCESSING
totalinteger
範例：
3
completedinteger
範例：
0
creditsUsedinteger
範例：
0
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)