Tài liệu Tham chiếu API Tham chiếu SDK Sử dụng Agent Kỹ năng AI

Tài khoản

Tạo tác vụ nghiên cứu Tavily

Xếp hàng một tác vụ nghiên cứu bất đồng bộ. Trường bắt buộc theo OpenAPI là input (không phải query); model là mini, pro hoặc auto, còn stream=true trả về luồng SSE. Nên dùng xác thực Bearer; cũng hỗ trợ api_key tùy chọn trong JSON body. Nghiên cứu được tính theo mức dùng, dựa trên credits thực tế: mini động trong khoảng 4–110 credits và pro trong khoảng 15–250 credits; auto theo tầng được chọn. Hạn mức miễn phí không áp dụng cho research mà chỉ bao gồm search, extract, crawl, map và :online.

POST/v1/research

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Body

inputbắt buộc

string

Tác vụ hoặc câu hỏi cần nghiên cứu. Trường OpenAPI là input; query không phải bí danh.

Example: What are the latest developments in AI?

model

string

Tầng của agent nghiên cứu: mini cho câu hỏi hẹp, pro cho nghiên cứu nhiều góc, hoặc auto để dịch vụ chọn.

miniproauto

Example: mini

stream

boolean

Có truyền kết quả nghiên cứu bằng SSE hay không; mặc định false.

Example: false

output_schema

object

JSON Schema cho đầu ra nghiên cứu; phải có properties và có thể có required.

propertiesbắt buộc

object

Định nghĩa thuộc tính của đối tượng đầu ra; mỗi giá trị là một trường JSON Schema.

required

string[]

Tên các thuộc tính bắt buộc trong đối tượng đầu ra.

Example: ["company"]

citation_format

string

Định dạng trích dẫn của báo cáo; mặc định numbered.

numberedmlaapachicago

Example: numbered

include_domains

string[]

Ưu tiên mềm cho nguồn; các miền khác vẫn có thể xuất hiện.

maxItems: 20

Example: ["sec.gov"]

exclude_domains

string[]

Danh sách chặn cứng các miền nguồn và miền con.

maxItems: 20

Example: ["reddit.com"]

output_length

string

Mục tiêu kích thước phản hồi; không phải giới hạn cứng, mặc định standard.

shortstandardlong

Example: standard

files

array<object>

Nguồn .txt, .md hoặc .json mã hóa Base64; tối đa 5 tệp và 80.000 từ tổng cộng.

maxItems: 5

namebắt buộc

string

Tên tệp có phần mở rộng .txt, .md hoặc .json.

Example: brief.md

databắt buộc

string

Nội dung tệp được mã hóa Base64.

Example: <base64-encoded file contents>

type

string

Kiểu mã hóa của data; mặc định là base64.

base64

Example: base64

api_key

string

Thông tin xác thực body tùy chọn của BazaarLink; nên dùng Authorization: Bearer và trường này sẽ bị xóa sau xác thực.

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"}'

Ví dụ phản hồi

Tác vụ nghiên cứu đã được xếp hàng và trả về request_id, created_at, trạng thái pending, input, model và 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
}