Web Content
Web crawling, URL discovery and page extraction.
Tavily Extract
1 つの URL または URL の配列から読み取り可能なコンテンツを抽出します。format で text または Markdown を選択します。results と failed_results の両方を確認してください。失敗した URL は、それ以外は成功した HTTP レスポンス内で報告されることがあります。include_usage を設定するとリソース使用量情報を受け取れます。usage.credits は Felo の課金ではありません。
料金の参考情報
- 計測方法：レスポンスユニット単位で計測。
- 参考リクエスト見積もり：0.024 USD。
- ユニットコスト基準：USD 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 各結果のファビコン 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
抽出されたコンテンツのファビコン 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"
}