Web Content
Web crawling, URL discovery and page extraction.
Tavily Extract
從一個 URL 或 URL 陣列擷取可讀內容。以 format 選擇 text 或 Markdown。請同時檢查 results 與 failed_results：失敗的 URL 可能在整體成功的 HTTP 回應中回報。設定 include_usage 以接收資源用量資訊；usage.credits 並非 Felo 費用。
計費參考
- 計量方式：依回應單位計量。
- 參考請求估算：0.024 美元。
- 單位成本基準：0.008 美元。
- 資源單位：
tavily_credit。 - 參考客戶乘數：1.0。不得再次套用於已結算的客戶金額。
- 成本基礎不構成最終客戶價格，即使為零亦同。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- urls必填
要擷取內容的 URL。單一 URL 字串和 URL 字串陣列皆可接受。
- 類型: string
要擷取內容的 URL。單一 URL 字串和 URL 字串陣列皆可接受。
- 類型: integerchunks
_per _source 最小值:1最大值:5每個來源傳回的相關區塊最大數。僅在提供 query 時可用。
- 類型: string 列舉extract
_depth 擷取過程的深度。
值- basic
- advanced
- 類型: string 列舉format
擷取的網頁內容格式。
值- markdown
- text
- 類型: booleaninclude
_favicon 為每筆結果包含 favicon URL。
- 類型: booleaninclude
_images 包含從 URL 擷取的圖片清單。
- 類型: booleaninclude
_usage 在回應中包含資源用量資訊。此資訊不是 Felo 計費資訊。
- 類型: stringquery
用於對擷取的內容區塊重新排序的使用者意圖。
- 類型: number 格式: floattimeout最小值:1最大值:60
URL 擷取的最長等待時間（秒）。省略時，預設逾時取決於 extract_depth：basic 為 10 秒，advanced 為 30 秒。
- 類型: object200
已成功傳回擷取結果。
- 類型: array string[]failed
_results 無法處理的 URL 清單。
- 類型: stringrequest
_id 唯一的請求識別碼。
- 類型: number 格式: floatresponse
_time 完成該請求所用的時間（秒）。
- 類型: array object[]results
- favicon類型: string | null
擷取內容的 Favicon URL。
- images類型: array string[]
include_images 為 true 時從 URL 擷取的圖片。
- raw類型: string
_content 從 URL 擷取的原始內容。
- title類型: string
已擷取頁面的標題。
- url類型: string
已擷取內容的 URL。
- 類型: objectusage
- credits類型: integer
此請求消耗的資源單位，不是美元或 Felo 額度。
application/json - 400
無法處理該要求。請檢查請求參數。
- 401
需要有效的 Felo API 金鑰。
- 402
由於未符合計費要求，要求無法繼續。
- 403
該帳戶無權執行此操作。
- 429
已達到要求或支出上限。
- 502
服務無法完成該要求。
- 503
API 或計費服務暫時無法使用。
- 504
服務在處理要求時逾時。
- default
錯誤回應；上游透傳回應可能採用供應商格式
application/json
curl --request POST https://openapi.felo.ai/v1/beta/tavily/extract \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"urls": ["https://example.com"], "extract_depth": "basic", "format": "text", "include_usage": true}'
{
"results": [
{
"url": "https://example.com",
"title": "Example Domain",
"raw_content": "This domain is for use in documentation examples.",
"images": []
}
],
"failed_results": [],
"response_time": 0.5,
"usage": {
"credits": 1
},
"request_id": "example-extract-request"
}