Web Search
Search public web content with Tavily.
Tavily Search
Tìm kiếm trên web và trả về kết quả đã xếp hạng kèm tiêu đề, URL và đoạn trích nội dung. query là bắt buộc. Dùng max_results để kiểm soát số lượng kết quả và search_depth để chọn chế độ tìm kiếm. answer, images và nội dung thô bổ sung chỉ được trả về khi có yêu cầu. Đặt include_usage để nhận thông tin sử dụng tài nguyên; usage.credits không phải khoản phí của Felo.
Tham chiếu giá
- Đo lường: Đơn vị phản hồi được đo lường.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.016.
- Cơ sở chi phí đơn vị: USD 0.008.
- Đơn vị tài nguyên:
tavily_credit. - Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
- Cơ sở chi phí không xác lập giá cuối cùng cho khách hàng, kể cả khi bằng 0.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
- Kiểu: stringquerybắt buộc
Truy vấn tìm kiếm cần thực thi với Tavily.
- Kiểu: booleanauto
_parameters Tự động định cấu hình tham số tìm kiếm dựa trên nội dung truy vấn.
- Kiểu: integerchunks
_per _source tối thiểu:1tối đa:3Số đoạn nội dung liên quan tối đa được trả về cho mỗi nguồn.
- Kiểu: string enumcountry
Tăng cường kết quả tìm kiếm từ một quốc gia cụ thể. Chỉ khả dụng khi topic là general.
giá trị- afghanistan
- albania
- algeria
- andorra
- angola
- Kiểu: string Định dạng: dateend
_date Trả về kết quả trước ngày kết thúc đã chỉ định.
- Kiểu: array string[] …150exclude
_domains Danh sách các tên miền cần loại trừ cụ thể khỏi kết quả tìm kiếm.
- include
_answer Bao gồm câu trả lời do LLM tạo. true dùng chế độ trả lời mặc định; basic hoặc advanced chọn chế độ tạo câu trả lời.
- Kiểu: boolean
Bao gồm câu trả lời do LLM tạo. true dùng chế độ trả lời mặc định; basic hoặc advanced chọn chế độ tạo câu trả lời.
- Kiểu: array string[] …300include
_domains Danh sách các tên miền cần bao gồm cụ thể trong kết quả tìm kiếm.
- Kiểu: booleaninclude
_favicon Bao gồm URL favicon cho mỗi kết quả.
- Kiểu: booleaninclude
_image _descriptions Thêm văn bản mô tả cho mỗi hình ảnh khi include_images là true.
- Kiểu: booleaninclude
_images Thực hiện tìm kiếm hình ảnh và bao gồm kết quả.
- include
_raw _content Bao gồm nội dung đã làm sạch và phân tích cho mỗi kết quả tìm kiếm. true hoặc markdown trả về markdown; text trả về văn bản thuần và có thể làm tăng độ trễ.
- Kiểu: boolean
Bao gồm nội dung đã làm sạch và phân tích cho mỗi kết quả tìm kiếm. true hoặc markdown trả về markdown; text trả về văn bản thuần và có thể làm tăng độ trễ.
- Kiểu: booleaninclude
_usage Bao gồm thông tin sử dụng tài nguyên trong phản hồi. Đây không phải thông tin thanh toán của Felo.
- Kiểu: integermax
_results tối thiểu:0tối đa:20Số kết quả tìm kiếm tối đa cần trả về.
- Kiểu: booleansafe
_search Lọc bỏ nội dung người lớn hoặc không an toàn khỏi kết quả tìm kiếm. Chỉ dành cho Enterprise; không được hỗ trợ khi search_depth là fast hoặc ultra-fast.
- Kiểu: string enumsearch
_depth Kiểm soát sự đánh đổi giữa độ trễ và độ liên quan. advanced mang lại độ liên quan cao nhất với độ trễ và chi phí cao hơn; basic cân bằng; fast và ultra-fast tối ưu cho độ trễ thấp hơn.
giá trị- advanced
- basic
- fast
- ultra
-fast
- Kiểu: string Định dạng: datestart
_date Trả về kết quả sau ngày bắt đầu đã chỉ định.
- Kiểu: string enumtime
_range Khoảng thời gian để lọc kết quả dựa trên ngày xuất bản.
giá trị- day
- week
- month
- year
- d
- w
- m
- y
- Kiểu: string enumtopic
Danh mục của tìm kiếm.
giá trị- general
- news
- finance
- Kiểu: object200
Kết quả tìm kiếm được trả về thành công.
- Kiểu: string | nullanswer
Câu trả lời ngắn do LLM tạo. Trình bày dưới dạng null khi include_answer là false hoặc không có câu trả lời nào được tạo.
- Kiểu: array object[]images
- descriptionKiểu: string
Mô tả hình ảnh.
- urlKiểu: string
URL hình ảnh.
- Kiểu: stringquery
Truy vấn tìm kiếm đã được thực thi.
- Kiểu: stringrequest
_id Mã định danh yêu cầu duy nhất.
- Kiểu: number Định dạng: floatresponse
_time Thời gian tính bằng giây để hoàn thành yêu cầu.
- Kiểu: array object[]results
- contentKiểu: string
Đoạn trích nội dung của kết quả tìm kiếm.
- faviconKiểu: string | null
URL favicon của kết quả tìm kiếm.
- rawKiểu: string | null
_content Nội dung nguồn đã làm sạch và phân tích. Null trừ khi include_raw_content được yêu cầu hoặc không có nội dung thô.
- scoreKiểu: number Định dạng: float
Điểm liên quan của kết quả tìm kiếm.
- titleKiểu: string
Tiêu đề của kết quả tìm kiếm.
- urlKiểu: string
URL của kết quả tìm kiếm.
- Kiểu: objectusage
- creditsKiểu: integer
Đơn vị tài nguyên được yêu cầu này tiêu thụ, không phải USD hay tín dụng Felo.
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
application/json
curl --request POST https://openapi.felo.ai/v1/beta/tavily/search \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"query": "Python official documentation", "search_depth": "basic", "max_results": 2, "include_usage": true}'
{
"query": "Python official documentation",
"answer": null,
"images": [],
"results": [
{
"title": "Python Documentation",
"url": "https://docs.python.org/3/",
"content": "Documentation for the Python programming language.",
"score": 0.98,
"raw_content": null
}
],
"response_time": 1.2,
"usage": {
"credits": 1
},
"request_id": "example-search-request"
}