계정

Tavily 리서치 작업 생성

비동기 리서치 작업을 대기열에 넣습니다. OpenAPI에서 필수 입력 필드는 input(query가 아님)이며 model은 mini, pro 또는 auto입니다. stream=true이면 SSE 스트림을 반환합니다. Bearer 인증을 권장하며 JSON body의 선택적 api_key도 지원합니다. 연구는 실제 사용한 credits에 따라 사용량 기반으로 청구됩니다. mini는 동적으로 4–110 credits, pro는 15–250 credits 범위이며 auto는 선택한 계층을 따릅니다. 무료 허용량은 research에 적용되지 않고 search, extract, crawl, map 및 :online에 적용됩니다.

POST/v1/research

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

Body

input필수

string

조사할 작업 또는 질문입니다. OpenAPI 필드는 input이며 query는 별칭이 아닙니다.

Example: What are the latest developments in AI?

model

string

리서치 에이전트 계층입니다. 좁은 질문은 mini, 다각도 조사는 pro, 서비스 선택은 auto를 사용합니다.

miniproauto

Example: mini

stream

boolean

연구 결과를 SSE로 스트리밍할지 여부이며 기본값은 false입니다.

Example: false

output_schema

object

연구 출력의 JSON Schema이며 properties는 필수이고 required는 선택입니다.

properties필수

object

출력 객체의 속성 정의이며 각 값은 JSON Schema 필드입니다.

required

string[]

출력 객체에서 필수인 속성 이름 목록입니다.

Example: ["company"]

citation_format

string

리서치 보고서의 인용 형식이며 기본값은 numbered입니다.

numberedmlaapachicago

Example: numbered

include_domains

string[]

소스에 대한 우선순위이며 다른 도메인도 보고서에 포함될 수 있습니다.

maxItems: 20

Example: ["sec.gov"]

exclude_domains

string[]

소스 도메인과 하위 도메인을 강제로 차단하는 목록입니다.

maxItems: 20

Example: ["reddit.com"]

output_length

string

응답 크기 목표이며 하드 제한은 아닙니다. 기본값은 standard입니다.

shortstandardlong

Example: standard

files

array<object>

Base64로 인코딩한 .txt, .md 또는 .json 소스이며 최대 5개 파일, 총 80,000단어입니다.

maxItems: 5

name필수

string

.txt, .md 또는 .json 확장자를 포함한 파일 이름입니다.

Example: brief.md

data필수

string

파일 내용의 Base64 인코딩 값입니다.

Example: <base64-encoded file contents>

type

string

data의 인코딩이며 기본값은 base64입니다.

base64

Example: base64

api_key

string

선택적 BazaarLink body 자격 증명입니다. Authorization: Bearer를 권장하며 인증 후 이 필드는 제거됩니다.

Example: YOUR_BAZAARLINK_API_KEY

POST /v1/research

1
2
3
4
curl -X POST https://api.bazaarlink.ai/v1/research \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"What are the latest developments in AI?","model":"mini"}'

응답 예시

리서치 작업을 대기열에 추가하고 request_id, created_at, pending 상태, input, model 및 response_time을 반환합니다.

1
2
3
4
5
6
7
8
{
  "request_id": "123e4567-e89b-12d3-a456-426614174111",
  "created_at": "2025-01-15T10:30:00Z",
  "status": "pending",
  "input": "What are the latest developments in AI?",
  "model": "mini",
  "response_time": 1.23
}