Felo API PlatformFelo API Platform
Wszystkie endpointy Tavily
v0.2.0-beta
OpenAPI 3.1.0

Ekstrakcja Tavily

Felo API Support
MIT
Serwer:https://openapi.felo.ai
Biblioteki klienckie
Shell Curl

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Operacje

Ekstrakcja Tavily

​

Wyodrębnia czytelną treść z jednego adresu URL lub tablicy adresów URL. Wybierz tekst lub Markdown za pomocą format. Sprawdzaj zarówno results, jak i failed_results: nieudany adres URL może zostać zgłoszony w skądinąd udanej odpowiedzi HTTP. Ustaw include_usage, aby otrzymać informacje o zużyciu zasobów; usage.credits nie jest opłatą Felo.

Cennik referencyjny

  • Rozliczanie: naliczone jednostki odpowiedzi.
  • Szacunek referencyjny dla żądania: USD 0.024.
  • Podstawa kosztu jednostkowego: USD 0.008.
  • Jednostka zasobu: tavily_credit.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.
  • Podstawy kosztu nie ustalają ostatecznej ceny dla klienta, również gdy wynoszą zero.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść
wymagane
application/json
  • urls
    wymagane

    Adres URL lub adresy URL, z których ma zostać wyodrębniona treść. Akceptowane są zarówno pojedynczy ciąg URL, jak i tablica ciągów URL.

    • Typ: string

      Adres URL lub adresy URL, z których ma zostać wyodrębniona treść. Akceptowane są zarówno pojedynczy ciąg URL, jak i tablica ciągów URL.

  • chunks_per_source
    Typ: integer
    min.:  
    1
    maks.:  
    5

    Maksymalna liczba odpowiednich fragmentów zwracanych na źródło. Dostępne tylko wtedy, gdy podano query.

  • extract_depth
    Typ: string enum

    Głębokość procesu ekstrakcji.

    wartości
    • basic
    • advanced
  • format
    Typ: string enum

    Format wyodrębnionej treści strony internetowej.

    wartości
    • markdown
    • text
  • include_favicon
    Typ: boolean

    Uwzględnij adres URL favikony dla każdego wyniku.

  • include_images
    Typ: boolean

    Uwzględnij listę obrazów wyodrębnionych z adresów URL.

  • include_usage
    Typ: boolean

    Uwzględnij informacje o zużyciu zasobów w odpowiedzi. To nie są informacje rozliczeniowe Felo.

  • query
    Typ: string

    Intencja użytkownika do ponownego rankingowania wyodrębnionych fragmentów treści.

  • timeout
    Typ: number Format: float
    min.:  
    1
    maks.:  
    60

    Maksymalny czas oczekiwania na ekstrakcję adresu URL w sekundach. W razie pominięcia domyślne limity czasu zależą od extract_depth: 10 sekund dla basic i 30 sekund dla advanced.

Odpowiedzi
  • 200
    Typ: object

    Wyniki ekstrakcji zwrócone pomyślnie.

    • failed_results
      Typ: array string[]

      Lista adresów URL, których nie udało się przetworzyć.

    • request_id
      Typ: string

      Unikalny identyfikator żądania.

    • response_time
      Typ: number Format: float

      Czas w sekundach potrzebny na ukończenie żądania.

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

        Adres URL favikony wyodrębnionej treści.

      • images
        Typ: array string[]

        Obrazy wyodrębnione z adresu URL, gdy include_images ma wartość true.

      • raw_content
        Typ: string

        Wyodrębniona surowa treść z adresu URL.

      • title
        Typ: string

        Tytuł wyodrębnionej strony.

      • url
        Typ: string

        Adres URL wyodrębnionej treści.

    • usage
      Typ: object
      • credits
        Typ: integer

        Jednostki zasobów zużyte przez to żądanie, a nie USD ani kredyty Felo.

    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

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

Wyniki ekstrakcji zwrócone pomyślnie.

Tavily Extract