웹 페이지 최대 20개의 본문을 LLM에 바로 넣을 수 있는 markdown/text로 한 번에 추출합니다. 질의를 주면 관련도 순 청크로 재정렬합니다. 추출에 성공한 URL 단위로 과금되며(basic URL당 약 4 크레딧), 실패한 URL은 환불됩니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "tavily/extract",
"input": {
"urls": [
"https://docs.tavily.com/documentation/api-credits"
],
"extract_depth": "basic",
"format": "markdown"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
urls | array | Yes | - | 본문을 추출할 웹 페이지 URL 목록입니다 (1-20개). |
query | string | No | - | 추출 청크를 관련도 순으로 재정렬할 의도(선택)입니다. 지정하면 raw_content에 상위 청크가 [...]로 이어져 들어갑니다. |
chunks_per_source | integer | No | - | query를 지정했을 때 URL당 청크 수입니다 (1-5, 기본 3). |
extract_depth | string | No | basic | advanced는 표·임베디드 콘텐츠까지 추출하고 더 많은 페이지에서 성공하지만 2배 가격이며 지연이 늘어납니다. basicadvanced |
format | string | No | markdown | raw_content의 형식입니다. markdowntext |
include_images | boolean | No | false | 각 페이지에서 찾은 이미지 URL을 추가합니다. |
include_favicon | boolean | No | false | 각 페이지의 파비콘 URL을 추가합니다. |
timeout | number | No | - | 요청 타임아웃(초)입니다 (1-60). 기본값은 basic 10초, advanced 30초입니다. |
POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
페이지 하나의 본문을 반환합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "tavily/extract",
"input": {
"urls": [
"https://docs.tavily.com/documentation/api-credits"
],
"extract_depth": "basic",
"format": "markdown"
}
}'질의에 답하는 상위 청크 3개씩을 페이지별로 반환합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "tavily/extract",
"input": {
"urls": [
"https://en.wikipedia.org/wiki/Retrieval-augmented_generation",
"https://en.wikipedia.org/wiki/Large_language_model"
],
"query": "how does retrieval reduce hallucination",
"chunks_per_source": 3
}
}'