Felo API PlatformFelo API Platform
Wszystkie endpointy Exa
v0.2.0-beta
OpenAPI 3.1.0

Uruchom neuronowe wyszukiwanie semantyczne w sieci.

Serwer:https://openapi.felo.ai
Biblioteki klienckie

Exa

​

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

Uruchom neuronowe wyszukiwanie semantyczne w sieci.

​

Przeszukuj sieć według znaczenia, a nie słów kluczowych. query jest wymagane; zawęź przez category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate i ustaw numResults. Zwraca requestId, resolvedSearchType, searchTime, costDollars i results[] z id, title i url. id to adres URL i to jego przyjmuje post_exa_contents. ⚠️ Wyniki nie zawierają tekstu strony, jeśli o niego nie poprosisz: przekaż contents lub wykonaj kolejne wywołanie post_exa_contents. Wybierz to zamiast searchWeb, gdy zapytanie jest opisem, a nie słowami kluczowymi; wybierz Tavily, gdy chcesz tekst w tym samym wywołaniu, a post_exa_answer, gdy chcesz pisemną odpowiedź zamiast listy.

Cennik referencyjny

  • Rozliczanie: zgłoszony koszt odpowiedzi.
  • Szacunek referencyjny dla żądania: USD 0.017.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść
wymagane
application/json
  • query
    Typ: string
    wymagane

    Zapytanie wyszukiwania w języku naturalnym.

  • category
    Typ: string enum

    Opcjonalna wskazówka dotycząca rodzaju stron, które mają być traktowane priorytetowo.

    wartości
    • company
    • research paper
    • news
    • personal site
    • financial report
    • people
  • contents
    Typ: object

    Opcje treści zwracane wraz z każdym wynikiem.

    • highlights
      Typ: boolean

      Zwracaj wyróżnione istotne fragmenty.

    • summary
      Typ: boolean

      Zwracaj wygenerowane przez AI podsumowanie strony.

    • text
      Typ: boolean

      Zwracaj pełny tekst strony.

  • endPublishedDate
    Typ: string Format: date-time

    Zwracaj tylko wyniki opublikowane najpóźniej tego dnia (ISO 8601).

  • excludeDomains
    Typ: array string[]

    Wyklucz wyniki z tych domen.

  • includeDomains
    Typ: array string[]

    Zwracaj tylko wyniki z tych domen.

  • numResults
    Typ: integer
    min.:  
    1
    maks.:  
    100

    Liczba wyników do zwrócenia.

  • outputSchema
    Typ: object

    Schemat JSON używany do syntezy strukturalnego wyjścia z wyników.

  • startPublishedDate
    Typ: string Format: date-time

    Zwracaj tylko wyniki opublikowane najwcześniej tego dnia (ISO 8601).

  • stream
    Typ: boolean enum
    const:  
    false
    wartości
    • false
  • systemPrompt
    Typ: string

    Instrukcja określająca, jak generowane jest strukturalne wyjście.

  • type
    Typ: string enum

    Tryb wyszukiwania. auto pozwala Exa wybrać; tryby deep wymieniają opóźnienie na wyższą jakość wyszukiwania.

    wartości
    • auto
    • fast
    • instant
    • deep-lite
    • deep
    • deep-reasoning
Odpowiedzi
  • 200
    Typ: object

    Wyszukiwanie zakończone pomyślnie.

    • costDollars

      Rozbicie kosztów dostawcy za wykorzystanie zasobów. Wyłącznie informacyjne; nie jest to opłata klienta Felo ani dowód rozliczenia Felo.

    • output

      Strukturalne wyjście, obecne tylko wtedy, gdy podano outputSchema.

    • requestId
      Typ: string

      Identyfikator żądania Exa.

    • results
      Typ: array object[]

      Uszeregowane wyniki wyszukiwania.

      • author
        Typ: string
      • id
        Typ: string
      • publishedDate
        Typ: string
      • title
        Typ: string
      • url
        Typ: string
    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

    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.