Felo API PlatformFelo API Platform
Všechny endpointy Exa
v0.2.0-beta
OpenAPI 3.1.0

Spusťte neuronové sémantické vyhledávání na webu.

Server:https://openapi.felo.ai
Klientské knihovny

Exa

​

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

Spusťte neuronové sémantické vyhledávání na webu.

​

Prohledávejte web podle významu, nikoli podle klíčových slov. query je povinné; zužte pomocí category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate a nastavte numResults. Vrací requestId, resolvedSearchType, searchTime, costDollars a results[] s id, title a url. id je adresa URL a právě ji přebírá post_exa_contents. ⚠️ Výsledky neobsahují text stránky, pokud o něj nepožádáte: předejte contents nebo navazujte voláním post_exa_contents. Zvolte to místo searchWeb, když je dotaz popisem, nikoli klíčovými slovy; zvolte Tavily, když chcete text ve stejném volání, a post_exa_answer, když chcete psanou odpověď místo seznamu.

Cenová reference

  • Účtování: nahlášené náklady na odpověď.
  • Referenční odhad požadavku: USD 0.017.
  • Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo
povinné
application/json
  • query
    Typ: string
    povinné

    Vyhledávací dotaz v přirozeném jazyce.

  • category
    Typ: string enum

    Volitelný pokyn o typu stránek, které mají být upřednostněny.

    hodnoty
    • company
    • research paper
    • news
    • personal site
    • financial report
    • people
  • contents
    Typ: object

    Možnosti obsahu vrácené u každého výsledku.

    • highlights
      Typ: boolean

      Vracet zvýrazněné relevantní úryvky.

    • summary
      Typ: boolean

      Vracet souhrn stránky vygenerovaný AI.

    • text
      Typ: boolean

      Vracet úplný text stránky.

  • endPublishedDate
    Typ: string Formát: date-time

    Vracet pouze výsledky publikované k tomuto datu ISO 8601 nebo dříve.

  • excludeDomains
    Typ: array string[]

    Vyloučit výsledky z těchto domén.

  • includeDomains
    Typ: array string[]

    Vracet pouze výsledky z těchto domén.

  • numResults
    Typ: integer
    min:  
    1
    max:  
    100

    Počet výsledků k vrácení.

  • outputSchema
    Typ: object

    JSON Schema použitý k syntéze strukturovaného výstupu z výsledků.

  • startPublishedDate
    Typ: string Formát: date-time

    Vracet pouze výsledky publikované k tomuto datu ISO 8601 nebo později.

  • stream
    Typ: boolean enum
    const:  
    false
    hodnoty
    • false
  • systemPrompt
    Typ: string

    Pokyn, který určuje, jak se strukturovaný výstup generuje.

  • type
    Typ: string enum

    Režim vyhledávání. auto nechává volbu na Exa; režimy deep vyměňují latenci za kvalitnější vyhledávání.

    hodnoty
    • auto
    • fast
    • instant
    • deep-lite
    • deep
    • deep-reasoning
Odpovědi
  • 200
    Typ: object

    Hledání bylo úspěšně dokončeno.

    • costDollars

      Rozpis nákladů poskytovatele za využití prostředků. Pouze informativní; není to poplatek zákazníka Felo ani fakturační doklad Felo.

    • output

      Strukturovaný výstup, přítomný pouze tehdy, když bylo zadáno outputSchema.

    • requestId
      Typ: string

      Identifikátor požadavku Exa.

    • results
      Typ: array object[]

      Seřazené výsledky vyhledávání.

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

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

    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.