Felo API PlatformFelo API Platform
Tüm Tavily endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

Tavily Çıkarımı

Felo API Support
MIT
Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları
Shell Curl

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content İşlemler

Tavily Çıkarımı

​

Bir URL veya URL dizisinden okunabilir içerik çıkarır. format ile metin veya Markdown seçin. Hem results hem de failed_results değerlerini inceleyin: başarısız bir URL, aksi halde başarılı olan bir HTTP yanıtında bildirilebilir. Kaynak kullanım bilgilerini almak için include_usage değerini ayarlayın; usage.credits bir Felo ücreti değildir.

Fiyatlandırma referansı

  • Ölçümlendirme: ölçümlendirilen yanıt birimleri.
  • Referans istek tahmini: USD 0.024.
  • Birim maliyet esası: USD 0.008.
  • Kaynak birimi: tavily_credit.
  • Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.
  • Maliyet esasları, sıfır olduğunda dahi nihai müşteri fiyatını belirlemez.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Gövde
gerekli
application/json
  • urls
    gerekli

    İçeriğin çıkarılacağı URL veya URL'ler. Hem tek bir URL dizesi hem de URL dizeleri dizisi kabul edilir.

    • Tür: string

      İçeriğin çıkarılacağı URL veya URL'ler. Hem tek bir URL dizesi hem de URL dizeleri dizisi kabul edilir.

  • chunks_per_source
    Tür: integer
    min:  
    1
    maks:  
    5

    Kaynak başına döndürülen maksimum ilgili parça sayısı. Yalnızca query sağlandığında kullanılabilir.

  • extract_depth
    Tür: string enum

    Çıkarma işleminin derinliği.

    değerler
    • basic
    • advanced
  • format
    Tür: string enum

    Çıkarılan web sayfası içeriğinin biçimi.

    değerler
    • markdown
    • text
  • include_favicon
    Tür: boolean

    Her sonuç için favicon URL'sini ekleyin.

  • include_images
    Tür: boolean

    URL'lerden çıkarılan görsellerin listesini dahil edin.

  • include_usage
    Tür: boolean

    Yanıta kaynak kullanım bilgilerini dahil edin. Bu, Felo faturalandırma bilgisi değildir.

  • query
    Tür: string

    Çıkarılan içerik parçalarını yeniden sıralamak için kullanıcı niyeti.

  • timeout
    Tür: number Biçim: float
    min:  
    1
    maks:  
    60

    URL çıkarma için beklenecek maksimum süre (saniye). Atlanırsa varsayılan zaman aşımları extract_depth değerine bağlıdır: basic için 10 saniye, advanced için 30 saniye.

Yanıtlar
  • 200
    Tür: object

    Çıkarım sonuçları başarıyla döndürüldü.

    • failed_results
      Tür: array string[]

      İşlenemeyen URL'lerin listesi.

    • request_id
      Tür: string

      Benzersiz istek tanımlayıcısı.

    • response_time
      Tür: number Biçim: float

      İsteğin tamamlanmasının aldığı süre (saniye).

    • results
      Tür: array object[]
      • favicon
        Tür: string | null

        Çıkarılan içeriğin favicon URL'si.

      • images
        Tür: array string[]

        include_images true olduğunda URL'den çıkarılan görseller.

      • raw_content
        Tür: string

        URL'den çıkarılan ham içerik.

      • title
        Tür: string

        Çıkarılan sayfanın başlığı.

      • url
        Tür: string

        Çıkarılan içeriğin URL'si.

    • usage
      Tür: object
      • credits
        Tür: integer

        Bu istek tarafından tüketilen kaynak birimleri; USD veya Felo kredisi değil.

    application/json
  • 400

    İstek işlenemedi. İstek parametrelerini kontrol edin.

  • 401

    Geçerli bir Felo API anahtarı gerekir.

  • 402

    Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.

  • 403

    Hesabın bu işlemi gerçekleştirme izni yok.

  • 429

    İstek veya harcama sınırına ulaşıldı.

  • 502

    Hizmet isteği tamamlayamadı.

  • 503

    API veya faturalandırma hizmeti geçici olarak kullanılamıyor.

  • 504

    İstek işlenirken hizmet zaman aşımına uğradı.

  • default

    Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

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

Çıkarım sonuçları başarıyla döndürüldü.

Tavily Extract