Felo API PlatformFelo API Platform
Tất cả endpoint của Tavily
v0.2.0-beta
OpenAPI 3.1.0

Tavily Extract

Máy chủ:https://openapi.felo.ai
Thư viện client

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Thao tác

Tavily Extract

​

Trích xuất nội dung có thể đọc từ một URL hoặc một mảng URL. Chọn văn bản hoặc Markdown bằng format. Kiểm tra cả results và failed_results: một URL thất bại vẫn có thể được báo trong phản hồi HTTP thành công. Đặt include_usage để nhận thông tin sử dụng tài nguyên; usage.credits không phải khoản phí của Felo.

Tham chiếu giá

  • Đo lường: Đơn vị phản hồi được đo lường.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 0.024.
  • Cơ sở chi phí đơn vị: USD 0.008.
  • Đơn vị tài nguyên: tavily_credit.
  • Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
  • Cơ sở chi phí không xác lập giá cuối cùng cho khách hàng, kể cả khi bằng 0.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Phần thân
bắt buộc
application/json
  • urls
    bắt buộc

    URL hoặc các URL cần trích xuất nội dung. Chấp nhận cả một chuỗi URL đơn lẻ và một mảng chuỗi URL.

    • Kiểu: string

      URL hoặc các URL cần trích xuất nội dung. Chấp nhận cả một chuỗi URL đơn lẻ và một mảng chuỗi URL.

  • chunks_per_source
    Kiểu: integer
    tối thiểu:  
    1
    tối đa:  
    5

    Số đoạn nội dung liên quan tối đa được trả về cho mỗi nguồn. Chỉ khả dụng khi có truy vấn.

  • extract_depth
    Kiểu: string enum

    Độ sâu của quá trình trích xuất.

    giá trị
    • basic
    • advanced
  • format
    Kiểu: string enum

    Định dạng của nội dung trang web được trích xuất.

    giá trị
    • markdown
    • text
  • include_favicon
    Kiểu: boolean

    Bao gồm URL favicon cho mỗi kết quả.

  • include_images
    Kiểu: boolean

    Bao gồm danh sách hình ảnh được trích xuất từ các URL.

  • include_usage
    Kiểu: boolean

    Bao gồm thông tin sử dụng tài nguyên trong phản hồi. Đây không phải thông tin thanh toán của Felo.

  • query
    Kiểu: string

    Ý định của người dùng để xếp hạng lại các đoạn nội dung được trích xuất.

  • timeout
    Kiểu: number Định dạng: float
    tối thiểu:  
    1
    tối đa:  
    60

    Thời gian tối đa tính bằng giây để chờ trích xuất URL. Nếu bỏ qua, thời gian chờ mặc định phụ thuộc vào extract_depth: 10 giây cho basic và 30 giây cho advanced.

Phản hồi
  • 200
    Kiểu: object

    Kết quả trích xuất được trả về thành công.

    • failed_results
      Kiểu: array string[]

      Danh sách các URL không thể xử lý.

    • request_id
      Kiểu: string

      Mã định danh yêu cầu duy nhất.

    • response_time
      Kiểu: number Định dạng: float

      Thời gian tính bằng giây để hoàn thành yêu cầu.

    • results
      Kiểu: array object[]
      • favicon
        Kiểu: string | null

        URL favicon của nội dung được trích xuất.

      • images
        Kiểu: array string[]

        Hình ảnh được trích xuất từ URL khi include_images là true.

      • raw_content
        Kiểu: string

        Nội dung thô được trích xuất từ URL.

      • title
        Kiểu: string

        Tiêu đề của trang được trích xuất.

      • url
        Kiểu: string

        URL của nội dung được trích xuất.

    • usage
      Kiểu: object
      • credits
        Kiểu: integer

        Đơn vị tài nguyên được yêu cầu này tiêu thụ, không phải USD hay tín dụng Felo.

    application/json
  • 400

    Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

  • 401

    Cần có khóa API Felo hợp lệ.

  • 402

    Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

  • 403

    Tài khoản không được phép thực hiện thao tác này.

  • 429

    Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

  • 502

    Dịch vụ không thể hoàn tất yêu cầu.

  • 503

    API hoặc dịch vụ thanh toán tạm thời không khả dụng.

  • 504

    Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

  • default

    Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

    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