Felo API PlatformFelo API Platform
Semua endpoint Tavily
v0.2.0-beta
OpenAPI 3.1.0

Tavily Extract

Server:https://openapi.felo.ai
Pustaka Klien

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Operasi

Tavily Extract

​

Ekstrak konten yang dapat dibaca dari satu URL atau array URL. Pilih teks atau Markdown dengan format. Periksa results dan failed_results: URL yang gagal dapat dilaporkan dalam respons HTTP yang berhasil. Setel include_usage untuk menerima informasi penggunaan sumber daya; usage.credits bukan biaya Felo.

Referensi harga

  • Metering: Unit respons terukur.
  • Estimasi referensi per permintaan: USD 0.024.
  • Dasar biaya unit: USD 0.008.
  • Unit sumber daya: tavily_credit.
  • Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.
  • Dasar biaya tidak menentukan harga pelanggan akhir, termasuk saat bernilai nol.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi
wajib
application/json
  • urls
    wajib

    URL atau URL-URL untuk mengekstrak konten. String URL tunggal dan array string URL keduanya diterima.

    • Tipe: string

      URL atau URL-URL untuk mengekstrak konten. String URL tunggal dan array string URL keduanya diterima.

  • chunks_per_source
    Tipe: integer
    min:  
    1
    maks:  
    5

    Jumlah maksimum potongan relevan yang dikembalikan per sumber. Hanya tersedia jika kueri diberikan.

  • extract_depth
    Tipe: string enum

    Kedalaman proses ekstraksi.

    nilai
    • basic
    • advanced
  • format
    Tipe: string enum

    Format konten halaman web yang diekstrak.

    nilai
    • markdown
    • text
  • include_favicon
    Tipe: boolean

    Sertakan URL favicon untuk setiap hasil.

  • include_images
    Tipe: boolean

    Sertakan daftar gambar yang diekstrak dari URL.

  • include_usage
    Tipe: boolean

    Sertakan informasi penggunaan sumber daya dalam respons. Ini bukan informasi penagihan Felo.

  • query
    Tipe: string

    Intent pengguna untuk memeringkat ulang potongan konten yang diekstrak.

  • timeout
    Tipe: number Format: float
    min:  
    1
    maks:  
    60

    Waktu maksimum dalam detik untuk menunggu ekstraksi URL. Jika dihilangkan, timeout default bergantung pada extract_depth: 10 detik untuk basic dan 30 detik untuk advanced.

Respons
  • 200
    Tipe: object

    Hasil ekstraksi berhasil dikembalikan.

    • failed_results
      Tipe: array string[]

      Daftar URL yang tidak dapat diproses.

    • request_id
      Tipe: string

      Pengenal permintaan unik.

    • response_time
      Tipe: number Format: float

      Waktu dalam detik yang dibutuhkan untuk menyelesaikan permintaan.

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

        URL favicon konten yang diekstrak.

      • images
        Tipe: array string[]

        Gambar yang diekstrak dari URL saat include_images bernilai true.

      • raw_content
        Tipe: string

        Konten mentah yang diekstrak dari URL.

      • title
        Tipe: string

        Judul halaman yang diekstrak.

      • url
        Tipe: string

        URL konten yang diekstrak.

    • usage
      Tipe: object
      • credits
        Tipe: integer

        Unit sumber daya yang dikonsumsi permintaan ini, bukan USD atau kredit Felo.

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

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