Web Content
Web crawling, URL discovery and page extraction.
Tavily Extract
하나의 URL 또는 URL 배열에서 읽을 수 있는 콘텐츠를 추출합니다. format으로 텍스트 또는 Markdown을 선택합니다. results와 failed_results를 모두 확인하세요. 실패한 URL은 그 외에는 성공적인 HTTP 응답에 보고될 수 있습니다. 리소스 사용 정보를 받으려면 include_usage를 설정하세요. usage.credits는 Felo 청구가 아닙니다.
가격 참고
- 과금 기준: 측정된 응답 단위.
- 참고 요청 추정치: USD 0.024.
- 단위 원가 기준: USD 0.008.
- 리소스 단위:
tavily_credit. - 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
- 원가 기준은 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
이 요청에서 소비된 리소스 단위이며 USD나 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"
}