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

Chạy tìm kiếm web ngữ nghĩa bằng mạng nơ-ron.

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

Exa

​

Semantic search, page content, cited answers and asynchronous research.

Chạy tìm kiếm web ngữ nghĩa bằng mạng nơ-ron.

​

Tìm kiếm web theo ngữ nghĩa thay vì theo từ khóa. query là bắt buộc; thu hẹp bằng category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate và đặt numResults. Trả về requestId, resolvedSearchType, searchTime, costDollars và results[] với id, title và url. id chính là URL, và đó là thứ post_exa_contents nhận. ⚠️ Kết quả không kèm văn bản trang trừ khi bạn yêu cầu: truyền contents, hoặc theo sau bằng post_exa_contents. Chọn công cụ này thay vì searchWeb khi truy vấn là một mô tả thay vì từ khóa; chọn Tavily khi muốn có văn bản trong cùng lần gọi, và post_exa_answer khi muốn câu trả lời bằng văn bản thay vì danh sách.

Tham chiếu giá

  • Đo lường: Chi phí phản hồi được báo cáo.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 0.017.
  • 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.

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
  • query
    Kiểu: string
    bắt buộc

    Truy vấn tìm kiếm bằng ngôn ngữ tự nhiên.

  • category
    Kiểu: string enum

    Gợi ý tùy chọn về loại trang cần ưu tiên.

    giá trị
    • company
    • research paper
    • news
    • personal site
    • financial report
    • people
  • contents
    Kiểu: object

    Tùy chọn nội dung trả về cùng mỗi kết quả.

    • highlights
      Kiểu: boolean

      Trả về các đoạn trích liên quan được làm nổi bật.

    • summary
      Kiểu: boolean

      Trả về bản tóm tắt do AI tạo của trang.

    • text
      Kiểu: boolean

      Trả về toàn bộ văn bản trang.

  • endPublishedDate
    Kiểu: string Định dạng: date-time

    Chỉ trả về kết quả được xuất bản vào hoặc trước ngày ISO 8601 này.

  • excludeDomains
    Kiểu: array string[]

    Loại trừ kết quả từ các tên miền này.

  • includeDomains
    Kiểu: array string[]

    Chỉ trả về kết quả từ các tên miền này.

  • numResults
    Kiểu: integer
    tối thiểu:  
    1
    tối đa:  
    100

    Số kết quả cần trả về.

  • outputSchema
    Kiểu: object

    JSON Schema dùng để tổng hợp đầu ra có cấu trúc từ các kết quả.

  • startPublishedDate
    Kiểu: string Định dạng: date-time

    Chỉ trả về kết quả được xuất bản vào hoặc sau ngày ISO 8601 này.

  • stream
    Kiểu: boolean enum
    const:  
    false
    giá trị
    • false
  • systemPrompt
    Kiểu: string

    Hướng dẫn cách tạo đầu ra có cấu trúc.

  • type
    Kiểu: string enum

    Chế độ tìm kiếm. auto để Exa tự chọn; các chế độ deep đánh đổi độ trễ để lấy kết quả chất lượng cao hơn.

    giá trị
    • auto
    • fast
    • instant
    • deep-lite
    • deep
    • deep-reasoning
Phản hồi
  • 200
    Kiểu: object

    Tìm kiếm hoàn tất thành công.

    • costDollars

      Phân tích chi phí của nhà cung cấp cho việc sử dụng tài nguyên. Chỉ mang tính thông tin; không phải khoản phí khách hàng Felo hay biên nhận thanh toán Felo.

    • output

      Đầu ra có cấu trúc, chỉ xuất hiện khi outputSchema được cung cấp.

    • requestId
      Kiểu: string

      Mã định danh yêu cầu Exa.

    • results
      Kiểu: array object[]

      Kết quả tìm kiếm đã xếp hạng.

      • author
        Kiểu: string
      • id
        Kiểu: string
      • publishedDate
        Kiểu: string
      • title
        Kiểu: string
      • url
        Kiểu: string
    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/exa/search
curl https://openapi.felo.ai/v1/beta/exa/search \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "query": "latest evaluation frameworks for AI agents",
  "type": "auto",
  "numResults": 10,
  "category": "company",
  "includeDomains": [
    ""
  ],
  "excludeDomains": [
    ""
  ],
  "startPublishedDate": "",
  "endPublishedDate": "",
  "contents": {
    "text": true,
    "highlights": true,
    "summary": true
  },
  "outputSchema": {},
  "systemPrompt": "",
  "stream": false
}'
{
  "requestId": "string",
  "results": [
    {
      "title": "string",
      "url": "string",
      "publishedDate": "string",
      "author": "string",
      "id": "string"
    }
  ],
  "output": null,
  "costDollars": null
}
Run a neural semantic web search.