Felo API PlatformFelo API Platform
Усі endpoint 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 перелік

    Підтримується лише 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 перелік
      обов'язкове
      значення
      • 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.