Felo API PlatformFelo API Platform
Alle Endpoints von Tavily
v0.2.0-beta
OpenAPI 3.1.0

Tavily-Extraktion

Felo API Support
MIT
Server:https://openapi.felo.ai
Client-Bibliotheken
Shell Curl

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Operationen

Tavily-Extraktion

​

Extrahiert lesbaren Inhalt aus einer URL oder einem Array von URLs. Wählen Sie mit format Text oder Markdown. Prüfen Sie sowohl results als auch failed_results: Eine fehlgeschlagene URL kann in einer ansonsten erfolgreichen HTTP-Antwort gemeldet werden. Setzen Sie include_usage, um Informationen zur Ressourcennutzung zu erhalten; usage.credits ist keine Felo-Gebühr.

Preisreferenz

  • Abrechnung: Abrechnete Antworteinheiten.
  • Referenzschätzung pro Anfrage: USD 0.024.
  • Kostenbasis pro Einheit: USD 0.008.
  • Ressourceneinheit: tavily_credit.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.
  • Kostenbasen legen den endgültigen Kundenpreis nicht fest, auch nicht bei null.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body
erforderlich
application/json
  • urls
    erforderlich

    Die URL oder URLs, aus denen Inhalte extrahiert werden sollen. Eine einzelne URL-Zeichenkette und ein Array von URL-Zeichenketten werden beide akzeptiert.

    • Typ: string

      Die URL oder URLs, aus denen Inhalte extrahiert werden sollen. Eine einzelne URL-Zeichenkette und ein Array von URL-Zeichenketten werden beide akzeptiert.

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

    Maximale Anzahl relevanter Chunks, die pro Quelle zurückgegeben werden. Nur verfügbar, wenn query angegeben ist.

  • extract_depth
    Typ: string enum

    Tiefe des Extraktionsvorgangs.

    Werte
    • basic
    • advanced
  • format
    Typ: string enum

    Format des extrahierten Webseiteninhalts.

    Werte
    • markdown
    • text
  • include_favicon
    Typ: boolean

    Die Favicon-URL für jedes Ergebnis einschließen.

  • include_images
    Typ: boolean

    Eine Liste der aus den URLs extrahierten Bilder einschließen.

  • include_usage
    Typ: boolean

    Informationen zur Ressourcennutzung in die Antwort aufnehmen. Dies sind keine Felo-Abrechnungsinformationen.

  • query
    Typ: string

    Nutzerabsicht für das Reranking extrahierter Inhalts-Chunks.

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

    Maximale Wartezeit in Sekunden für die URL-Extraktion. Wenn sie weggelassen wird, hängen die Standard-Timeouts von extract_depth ab: 10 Sekunden für basic und 30 Sekunden für advanced.

Antworten
  • 200
    Typ: object

    Extraktionsergebnisse erfolgreich zurückgegeben.

    • failed_results
      Typ: array string[]

      Liste der URLs, die nicht verarbeitet werden konnten.

    • request_id
      Typ: string

      Eindeutige Anfragekennung.

    • response_time
      Typ: number Format: float

      Zeit in Sekunden, die zum Abschließen der Anfrage benötigt wurde.

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

        Favicon-URL des extrahierten Inhalts.

      • images
        Typ: array string[]

        Aus der URL extrahierte Bilder, wenn include_images true ist.

      • raw_content
        Typ: string

        Extrahierter Rohinhalt aus der URL.

      • title
        Typ: string

        Titel der extrahierten Seite.

      • url
        Typ: string

        URL des extrahierten Inhalts.

    • usage
      Typ: object
      • credits
        Typ: integer

        Von dieser Anfrage verbrauchte Ressourceneinheiten, nicht USD oder Felo-Credits.

    application/json
  • 400

    Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.

  • 401

    Ein gültiger Felo-API-Schlüssel ist erforderlich.

  • 402

    Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.

  • 403

    Das Konto ist für diesen Vorgang nicht berechtigt.

  • 429

    Ein Anfrage- oder Ausgabenlimit wurde erreicht.

  • 502

    Der Dienst konnte die Anfrage nicht abschließen.

  • 503

    Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.

  • 504

    Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.

  • default

    Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

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

Extraktionsergebnisse erfolgreich zurückgegeben.

Tavily Extract