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

Отправка асинхронного запуска research Agent.

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

Exa

​

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

Exa Операции

Отправка асинхронного запуска research Agent.

​

Отправляет асинхронную задачу исследования. Укажите query; при необходимости systemPrompt и effort (только minimal). Idempotency-Key обязателен. HTTP 202 возвращает задачу; используйте её id с соответствующим эндпоинтом опроса Felo, пока она не станет completed, failed или cancelled. Поля цен задачи — это метаданные авторизации и расчётов провайдера, а не записи биллинга Felo.

Справочная информация о ценах

  • Тарификация: справочная стоимость за запрос.
  • Справочная оценка запроса: USD 0.1.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Заголовки
  • Idempotency-Key
    Тип: string
    обязательно

    Длина UTF-8 после обрезки пробелов должна составлять от 1 до 191 байта.

Тело
обязательно
application/json
  • query
    Тип: string
    обязательно

    Непустой запрос после удаления пробелов.

  • effort
    Тип: string | null enum

    Поддерживается только minimal effort; пропущенные, пустые и null-значения нормализуются до minimal.

    значения
    • null
    • minimal
  • systemPrompt
    Тип: string | null
Ответы
  • 202
    Тип: object

    Успех

    • completedAt
      Тип: string | null Формат: date-time
      обязательно

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • createdAt
      Тип: string | null Формат: date-time
      обязательно

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • endpoint
      Тип: string | null
      обязательно

      Идентификатор операции провайдера; для опроса используйте документированный путь задачи Felo.

    • error
      Тип: object | null
      обязательно
      • code
        Тип: string | null
      • message
        Тип: string | null
    • id
      Тип: string | null
      обязательно
    • object
      константа:  
      integration_async_job
      обязательно
    • output
      обязательно
    • pricing
      Тип: object | null
      обязательно

      Метаданные авторизации и расчётов провайдера в микро-USD; это не баланс Felo, не удержание и не квитанция об оплате.

      • authorizedMicrosUSD
        Тип: integer | null

        Integer numbers.

      • billingMode
        Тип: string | null
      • currency
        Тип: string | null
      • finalMicrosUSD
        Тип: integer | null

        Integer numbers.

    • status
      Тип: string enum
      обязательно
      значения
      • queued
      • running
      • completed
      • failed
      • cancelled
    • outputExpired
      Тип: boolean | null
    application/json
  • 400

    Запрос не удалось обработать. Проверьте параметры запроса.

  • 401

    Требуется действительный API-ключ Felo.

  • 402

    Запрос не может быть выполнен: не выполнено требование биллинга.

  • 403

    Аккаунту не разрешено выполнять эту операцию.

  • 429

    Достигнут лимит запросов или расходов.

  • 502

    Сервис не смог выполнить запрос.

  • 503

    API или сервис биллинга временно недоступны.

  • 504

    Истекло время ожидания обработки запроса.

  • default

    Операция завершилась ошибкой. Сохраните ID запроса из ответа при обращении в поддержку Felo.

Request Example for post/v1/beta/exa/agent/runs
curl https://openapi.felo.ai/v1/beta/exa/agent/runs \
  --request POST \
  --header 'Idempotency-Key: ' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "query": "Find the official documentation for Go"
}'
{
  "completedAt": null,
  "createdAt": null,
  "endpoint": null,
  "error": {
    "code": null,
    "message": null
  },
  "id": null,
  "object": "integration_async_job",
  "output": null,
  "outputExpired": null,
  "pricing": {
    "authorizedMicrosUSD": null,
    "billingMode": null,
    "currency": null,
    "finalMicrosUSD": null
  },
  "status": "queued"
}
Submit an asynchronous research Agent run.

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