Felo API PlatformFelo API Platform
Все эндпоинты Exa
v0.2.0-beta
OpenAPI 3.1.0

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

Сервер:https://openapi.felo.ai
Клиентские библиотеки

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 enum

    Необязательная подсказка о том, каким типам страниц отдавать приоритет.

    значения
    • 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 enum
    константа:  
    false
    значения
    • false
  • systemPrompt
    Тип: string

    Инструкция, определяющая, как формируется структурированный вывод.

  • type
    Тип: string enum

    Режим поиска. 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

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    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.

Нужна помощь?