Felo API PlatformFelo API Platform
Усі endpoint Exa
v0.2.0-beta
OpenAPI 3.1.0

Запуск нейромережевого семантичного вебпошуку.

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клієнтські бібліотеки
Shell Curl

Exa

​

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

Exa Операції

Запуск нейромережевого семантичного вебпошуку.

​

Шукає у вебі за змістом, а не за ключовими словами. query обов'язковий; звужуйте через category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate і задайте numResults. Повертає requestId, resolvedSearchType, searchTime, costDollars і results[] з id, title та url. id — це URL, і саме його приймає post_exa_contents. ⚠️ Результати не містять тексту сторінок, якщо не попросити: передайте contents або згодом викличте post_exa_contents. Обирайте замість searchWeb, коли запит — це опис, а не ключові слова; обирайте Tavily, коли текст потрібен у тому ж виклику, і post_exa_answer, коли потрібна письмова відповідь, а не список.

Довідкові ціни

  • Тарифікація: вартість відповіді за даними постачальника.
  • Довідкова оцінка запиту: USD 0.017.
  • Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Тіло
обов'язкове
application/json
  • query
    Тип: string
    обов'язкове

    Пошуковий запит природною мовою.

  • category
    Тип: string перелік

    Необов'язкова підказка про те, яким типам сторінок надавати пріоритет.

    значення
    • company
    • research paper
    • news
    • personal site
    • financial report
    • people
  • contents
    Тип: object

    Параметри вмісту, що повертається разом із кожним результатом.

    • highlights
      Тип: boolean

      Повертати виділені релевантні фрагменти.

    • summary
      Тип: boolean

      Повертати згенерований ШІ підсумок сторінки.

    • text
      Тип: boolean

      Повертати повний текст сторінки.

  • endPublishedDate
    Тип: string Формат: date-time

    Повертати лише результати, опубліковані не пізніше цієї дати ISO 8601.

  • excludeDomains
    Тип: array string[]

    Виключити результати з цих доменів.

  • includeDomains
    Тип: array string[]

    Повертати результати лише з цих доменів.

  • numResults
    Тип: integer
    мін.:  
    1
    макс.:  
    100

    Кількість результатів, які потрібно повернути.

  • outputSchema
    Тип: object

    JSON Schema, що використовується для синтезу структурованого виводу з результатів.

  • startPublishedDate
    Тип: string Формат: date-time

    Повертати лише результати, опубліковані не раніше цієї дати ISO 8601.

  • stream
    Тип: boolean перелік
    константа:  
    false
    значення
    • false
  • systemPrompt
    Тип: string

    Інструкція, що визначає, як формується структурований вивід.

  • type
    Тип: string перелік

    Режим пошуку. auto дозволяє Exa вибрати режим; режими deep обмінюють затримку на якісніше вилучення.

    значення
    • auto
    • fast
    • instant
    • deep-lite
    • deep
    • deep-reasoning
Відповіді
  • 200
    Тип: object

    Пошук виконано успішно.

    • costDollars

      Деталізація витрат постачальника за використання ресурсів. Лише для інформації; це не сума списання з клієнта Felo і не квитанція про оплату Felo.

    • output

      Структурований вивід, наявний лише за наданого outputSchema.

    • requestId
      Тип: string

      Ідентифікатор запиту Exa.

    • results
      Тип: array object[]

      Ранжовані результати пошуку.

      • author
        Тип: string
      • id
        Тип: string
      • publishedDate
        Тип: string
      • title
        Тип: string
      • url
        Тип: string
    application/json
  • 400

    Не вдалося обробити запит. Перевірте параметри запиту.

  • 401

    Потрібен дійсний API-ключ Felo.

  • 402

    Запит неможливо виконати: умови білінгу не виконано.

  • 403

    Обліковий запис не має дозволу на цю операцію.

  • 429

    Досягнуто ліміту запитів або витрат.

  • 502

    Служба не змогла виконати запит.

  • 503

    API або служба білінгу тимчасово недоступні.

  • 504

    Час очікування обробки запиту вичерпано.

  • default

    Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

    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.