Web Search
Search public web content with Tavily.
Vyhledávání Tavily
Prohledává web a vrací seřazené výsledky s názvy, URL a úryvky obsahu. query je povinné. Pomocí max_results ovládejte počet výsledků a pomocí search_depth vyberte režim vyhledávání. Další answer, images a surový obsah se vracejí pouze na vyžádání. Nastavte include_usage, abyste obdrželi informace o využití prostředků; usage.credits není poplatek Felo.
Cenová reference
- Účtování: měřené jednotky odpovědi.
- Referenční odhad požadavku: USD 0.016.
- Základ jednotkových nákladů: USD 0.008.
- Jednotka prostředku:
tavily_credit. - Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.
- Nákladové základny neurčují konečnou cenu pro zákazníka, a to ani když jsou nulové.
Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: stringquerypovinné
Vyhledávací dotaz, který se má provést v Tavily.
- Typ: booleanauto
_parameters Automaticky konfigurovat parametry vyhledávání na základě obsahu dotazu.
- Typ: integerchunks
_per _source min:1max:3Maximální počet relevantních částí vrácených na zdroj.
- Typ: string enumcountry
Zvýhodnit výsledky vyhledávání z konkrétní země. Dostupné pouze tehdy, když je topic general.
hodnoty- afghanistan
- albania
- algeria
- andorra
- angola
- Typ: string Formát: dateend
_date Vrátit výsledky před zadaným koncovým datem.
- Typ: array string[] …150exclude
_domains Seznam domén, které se mají z výsledků vyhledávání výslovně vyloučit.
- include
_answer Zahrnout odpověď vygenerovanou LLM. true používá výchozí režim odpovědi; basic nebo advanced volí režim generování odpovědi.
- Typ: boolean
Zahrnout odpověď vygenerovanou LLM. true používá výchozí režim odpovědi; basic nebo advanced volí režim generování odpovědi.
- Typ: array string[] …300include
_domains Seznam domén, které se mají do výsledků vyhledávání výslovně zahrnout.
- Typ: booleaninclude
_favicon Zahrnout adresu URL favikony pro každý výsledek.
- Typ: booleaninclude
_image _descriptions Přidat popisný text ke každému obrázku, když je include_images true.
- Typ: booleaninclude
_images Provést vyhledávání obrázků a zahrnout výsledky.
- include
_raw _content Zahrnout očištěný a parsovaný obsah pro každý výsledek vyhledávání. true nebo markdown vrací markdown; text vrací prostý text a může zvýšit latenci.
- Typ: boolean
Zahrnout očištěný a parsovaný obsah pro každý výsledek vyhledávání. true nebo markdown vrací markdown; text vrací prostý text a může zvýšit latenci.
- Typ: booleaninclude
_usage Zahrnout do odpovědi informace o spotřebě prostředků. Nejde o fakturační informace Felo.
- Typ: integermax
_results min:0max:20Maximální počet výsledků vyhledávání, které se mají vrátit.
- Typ: booleansafe
_search Odfiltrovat obsah pro dospělé nebo nebezpečný obsah z výsledků vyhledávání. Pouze Enterprise; není podporováno, když je search_depth fast nebo ultra-fast.
- Typ: string enumsearch
_depth Řídí kompromis mezi latencí a relevancí. advanced poskytuje nejvyšší relevanci s vyšší latencí a náklady; basic je vyvážený; fast a ultra-fast optimalizují nižší latenci.
hodnoty- advanced
- basic
- fast
- ultra
-fast
- Typ: string Formát: datestart
_date Vrátit výsledky po zadaném počátečním datu.
- Typ: string enumtime
_range Časový rozsah pro filtrování výsledků podle data publikace.
hodnoty- day
- week
- month
- year
- d
- w
- m
- y
- Typ: string enumtopic
Kategorie vyhledávání.
hodnoty- general
- news
- finance
- Typ: object200
Výsledky hledání byly úspěšně vráceny.
- Typ: string | nullanswer
Krátká odpověď vygenerovaná LLM. Má hodnotu null, když je include_answer false nebo se nevygeneruje žádná odpověď.
- Typ: array object[]images
- descriptionTyp: string
Popis obrázku.
- urlTyp: string
Adresa URL obrázku.
- Typ: stringquery
Vyhledávací dotaz, který byl proveden.
- Typ: stringrequest
_id Jedinečný identifikátor požadavku.
- Typ: number Formát: floatresponse
_time Doba v sekundách, za kterou byl požadavek dokončen.
- Typ: array object[]results
- contentTyp: string
Úryvek obsahu výsledku vyhledávání.
- faviconTyp: string | null
Adresa URL favikony výsledku vyhledávání.
- rawTyp: string | null
_content Očištěný a parsovaný obsah zdroje. Null, pokud není vyžádán include_raw_content nebo není k dispozici žádný surový obsah.
- scoreTyp: number Formát: float
Skóre relevance výsledku vyhledávání.
- titleTyp: string
Název výsledku vyhledávání.
- urlTyp: string
Adresa URL výsledku vyhledávání.
- Typ: objectusage
- creditsTyp: integer
Jednotky prostředků spotřebované tímto požadavkem, nikoli USD nebo kredity Felo.
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
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"
}