เอกสาร API ข้อมูลอ้างอิง SDK ข้อมูลอ้างอิง การใช้งาน Agent AI ทักษะ

บัญชี

สร้างงานวิจัย Tavily

จัดคิวงานวิจัยแบบอะซิงโครนัส ฟิลด์อินพุตที่จำเป็นตาม OpenAPI คือ input (ไม่ใช่ query) โดย model เลือกได้ mini, pro หรือ auto และ stream=true จะส่งผลลัพธ์เป็น SSE แนะนำให้ใช้การยืนยันตัวตนแบบ Bearer และรองรับ api_key ที่ไม่บังคับใน JSON body งานวิจัยคิดค่าบริการตามการใช้งานจริงจาก credits ที่ใช้ โดย mini อยู่ในช่วงแบบไดนามิก 4–110 credits และ pro 15–250 credits ส่วน auto ใช้ tier ที่เลือก โควตาฟรีไม่ครอบคลุม research แต่ครอบคลุม search, extract, crawl, map และ :online

POST/v1/research

การอนุญาต

Authorizationจำเป็น

string · header

API key เป็น bearer token ใน header Authorization

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>

แหล่งข้อมูล .txt, .md หรือ .json ที่เข้ารหัส Base64 สูงสุด 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

ข้อมูลรับรองใน body ของ BazaarLink ที่ไม่บังคับ แนะนำให้ใช้ 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
}