Felo API PlatformFelo API Platform
Alle endpoints van Exa
v0.2.0-beta
OpenAPI 3.1.0

Een asynchrone research Agent-run indienen.

Server:https://openapi.felo.ai
Clientbibliotheken

Exa

​

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

Een asynchrone research Agent-run indienen.

​

Dient een asynchrone onderzoekstaak in. Geef query op; optioneel systemPrompt en effort (alleen minimal). Idempotency-Key is vereist. HTTP 202 retourneert een job; gebruik het id ervan met het bijbehorende Felo-pollingendpoint tot deze completed, failed of cancelled is. Prijsvelden van de job zijn autorisatie- en afrekeningsmetadata van de provider, geen Felo-factureringsgegevens.

Prijsreferentie

  • Metering: Referentie per verzoek.
  • Referentieschatting per verzoek: USD 0.1.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Headers
  • Idempotency-Key
    Type: string
    verplicht

    De getrimde UTF-8-lengte moet 1 tot en met 191 bytes zijn.

Body
verplicht
application/json
  • query
    Type: string
    verplicht

    Niet-lege query na het trimmen van witruimte.

  • effort
    Type: string | null enum

    Alleen minimale inspanning wordt ondersteund; weggelaten, lege en null-waarden worden genormaliseerd naar minimaal.

    waarden
    • null
    • minimal
  • systemPrompt
    Type: string | null
Responsen
  • 202
    Type: object

    Geslaagd

    • completedAt
      Type: string | null Formaat: date-time
      verplicht

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

    • createdAt
      Type: string | null Formaat: date-time
      verplicht

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

    • endpoint
      Type: string | null
      verplicht

      Provider-operatie-identificatie; gebruik het gedocumenteerde Felo-jobpad voor polling.

    • error
      Type: object | null
      verplicht
      • code
        Type: string | null
      • message
        Type: string | null
    • id
      Type: string | null
      verplicht
    • object
      constante:  
      integration_async_job
      verplicht
    • output
      verplicht
    • pricing
      Type: object | null
      verplicht

      Autorisatie- en afwikkelingsmetadata van de provider in micro-USD; geen Felo-saldo, reservering of factureringsbewijs.

      • authorizedMicrosUSD
        Type: integer | null

        Integer numbers.

      • billingMode
        Type: string | null
      • currency
        Type: string | null
      • finalMicrosUSD
        Type: integer | null

        Integer numbers.

    • status
      Type: string enum
      verplicht
      waarden
      • queued
      • running
      • completed
      • failed
      • cancelled
    • outputExpired
      Type: boolean | null
    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    De bewerking is mislukt. Bewaar de verzoek-ID uit de respons wanneer je contact opneemt met Felo-ondersteuning.

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.