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)