Felo API PlatformFelo API Platform
Všechny endpointy Tavily
v0.2.0-beta
OpenAPI 3.1.0

Extrakce Tavily

Felo API Support
MIT
Server:https://openapi.felo.ai
Klientské knihovny
Shell Curl

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Operace

Extrakce Tavily

​

Extrahuje čitelný obsah z jedné URL nebo pole URL. Vyberte text nebo Markdown pomocí format. Kontrolujte jak results, tak failed_results: neúspěšná URL může být hlášena v jinak úspěšné HTTP odpovědi. 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.024.
  • 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.

Tělo
povinné
application/json
  • urls
    povinné

    Adresa URL nebo adresy URL, ze kterých se má obsah extrahovat. Přijímá se jak jeden řetězec URL, tak pole řetězců URL.

    • Typ: string

      Adresa URL nebo adresy URL, ze kterých se má obsah extrahovat. Přijímá se jak jeden řetězec URL, tak pole řetězců URL.

  • chunks_per_source
    Typ: integer
    min:  
    1
    max:  
    5

    Maximální počet relevantních částí vrácených na zdroj. Dostupné pouze při zadání query.

  • extract_depth
    Typ: string enum

    Hloubka procesu extrakce.

    hodnoty
    • basic
    • advanced
  • format
    Typ: string enum

    Formát extrahovaného obsahu webové stránky.

    hodnoty
    • markdown
    • text
  • include_favicon
    Typ: boolean

    Zahrnout adresu URL favikony pro každý výsledek.

  • include_images
    Typ: boolean

    Zahrnout seznam obrázků extrahovaných z adres URL.

  • include_usage
    Typ: boolean

    Zahrnout do odpovědi informace o spotřebě prostředků. Nejde o fakturační informace Felo.

  • query
    Typ: string

    Záměr uživatele pro přeřazení extrahovaných částí obsahu.

  • timeout
    Typ: number Formát: float
    min:  
    1
    max:  
    60

    Maximální doba čekání na extrakci adresy URL v sekundách. Pokud není uvedena, výchozí časové limity závisí na extract_depth: 10 sekund pro basic a 30 sekund pro advanced.

Odpovědi
  • 200
    Typ: object

    Výsledky extrakce byly úspěšně vráceny.

    • failed_results
      Typ: array string[]

      Seznam adres URL, které nebylo možné zpracovat.

    • request_id
      Typ: string

      Jedinečný identifikátor požadavku.

    • response_time
      Typ: number Formát: float

      Doba v sekundách, za kterou byl požadavek dokončen.

    • results
      Typ: array object[]
      • favicon
        Typ: string | null

        Adresa URL favikony extrahovaného obsahu.

      • images
        Typ: array string[]

        Obrázky extrahované z adresy URL, když je include_images true.

      • raw_content
        Typ: string

        Extrahovaný surový obsah z adresy URL.

      • title
        Typ: string

        Název extrahované stránky.

      • url
        Typ: string

        Adresa URL extrahovaného obsahu.

    • usage
      Typ: object
      • credits
        Typ: 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
Request Example for post/v1/beta/tavily/extract
curl --request POST https://openapi.felo.ai/v1/beta/tavily/extract \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"urls": ["https://example.com"], "extract_depth": "basic", "format": "text", "include_usage": true}'

{
  "results": [
    {
      "url": "https://example.com",
      "title": "Example Domain",
      "raw_content": "This domain is for use in documentation examples.",
      "images": []
    }
  ],
  "failed_results": [],
  "response_time": 0.5,
  "usage": {
    "credits": 1
  },
  "request_id": "example-extract-request"
}

Výsledky extrakce byly úspěšně vráceny.

Tavily Extract