Felo API PlatformFelo API Platform
Alle endpoints van Tavily
v0.2.0-beta
OpenAPI 3.1.0

Tavily-extractie

Felo API Support
MIT
Server:https://openapi.felo.ai
Clientbibliotheken
Shell Curl

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Operaties

Tavily-extractie

​

Extraheert leesbare inhoud uit één URL of een reeks URL's. Kies met format tekst of Markdown. Controleer zowel results als failed_results: een mislukte URL kan in een verder geslaagde HTTP-respons worden gemeld. Stel include_usage in om informatie over resourcegebruik te ontvangen; usage.credits is geen Felo-kostenpost.

Prijsreferentie

  • Metering: Gemeten responseenheden.
  • Referentieschatting per verzoek: USD 0.024.
  • Kostenbasis per eenheid: USD 0.008.
  • Resource-eenheid: tavily_credit.
  • Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.
  • Kostenbases bepalen niet de uiteindelijke klantprijs, ook niet wanneer die nul is.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body
verplicht
application/json
  • urls
    verplicht

    De URL of URL's waaruit inhoud moet worden geëxtraheerd. Een enkele URL-tekenreeks en een array van URL-tekenreeksen worden beide geaccepteerd.

    • Type: string

      De URL of URL's waaruit inhoud moet worden geëxtraheerd. Een enkele URL-tekenreeks en een array van URL-tekenreeksen worden beide geaccepteerd.

  • chunks_per_source
    Type: integer
    min.:  
    1
    max.:  
    5

    Maximaal aantal relevante chunks dat per bron wordt geretourneerd. Alleen beschikbaar wanneer query is opgegeven.

  • extract_depth
    Type: string enum

    Diepte van het extractieproces.

    waarden
    • basic
    • advanced
  • format
    Type: string enum

    Formaat van de geëxtraheerde webpagina-inhoud.

    waarden
    • markdown
    • text
  • include_favicon
    Type: boolean

    De favicon-URL voor elk resultaat opnemen.

  • include_images
    Type: boolean

    Een lijst opnemen met afbeeldingen die uit de URL's zijn geëxtraheerd.

  • include_usage
    Type: boolean

    Informatie over resourcegebruik opnemen in de respons. Dit zijn geen Felo-factureringsgegevens.

  • query
    Type: string

    Gebruikersintentie voor het herrangschikken van geëxtraheerde inhoudschunks.

  • timeout
    Type: number Formaat: float
    min.:  
    1
    max.:  
    60

    Maximale wachttijd in seconden voor URL-extractie. Als dit wordt weggelaten, zijn de standaardtime-outs afhankelijk van extract_depth: 10 seconden voor basic en 30 seconden voor advanced.

Responsen
  • 200
    Type: object

    Extractieresultaten succesvol geretourneerd.

    • failed_results
      Type: array string[]

      Lijst met URL's die niet konden worden verwerkt.

    • request_id
      Type: string

      Unieke verzoekidentificatie.

    • response_time
      Type: number Formaat: float

      Tijd in seconden die nodig was om het verzoek te voltooien.

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

        Favicon-URL van de geëxtraheerde inhoud.

      • images
        Type: array string[]

        Afbeeldingen die uit de URL zijn geëxtraheerd wanneer include_images true is.

      • raw_content
        Type: string

        Geëxtraheerde ruwe inhoud van de URL.

      • title
        Type: string

        Titel van de geëxtraheerde pagina.

      • url
        Type: string

        URL van de geëxtraheerde inhoud.

    • usage
      Type: object
      • credits
        Type: integer

        Door dit verzoek verbruikte resource-eenheden, niet USD of Felo-credits.

    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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

Extractieresultaten succesvol geretourneerd.

Tavily Extract