Felo API PlatformFelo API Platform
Tutti gli endpoint di Exa
v0.2.0-beta
OpenAPI 3.1.0

Invia un'esecuzione Agent di ricerca asincrona.

Server:https://openapi.felo.ai
Librerie client

Exa

​

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

Invia un'esecuzione Agent di ricerca asincrona.

​

Invia un'attività di ricerca asincrona. Fornisci query; facoltativamente systemPrompt ed effort (solo minimal). Idempotency-Key è obbligatorio. HTTP 202 restituisce un job; usa il suo id con il corrispondente endpoint di polling Felo finché non è completed, failed o cancelled. I campi di prezzo del job sono metadati di autorizzazione e regolamento del provider, non registrazioni di fatturazione Felo.

Riferimento prezzi

  • Misurazione: riferimento per richiesta.
  • Stima di riferimento per richiesta: USD 0.1.

Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Intestazioni
  • Idempotency-Key
    Tipo: string
    obbligatorio

    La lunghezza UTF-8 dopo il trim deve essere compresa tra 1 e 191 byte.

Corpo
obbligatorio
application/json
  • query
    Tipo: string
    obbligatorio

    Query non vuota dopo il trim degli spazi bianchi.

  • effort
    Tipo: string | null enum

    È supportato solo lo sforzo "minimal"; i valori omessi, vuoti e null vengono normalizzati a minimal.

    valori
    • null
    • minimal
  • systemPrompt
    Tipo: string | null
Risposte
  • 202
    Tipo: object

    Riuscito

    • completedAt
      Tipo: string | null Formato: date-time
      obbligatorio

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

    • createdAt
      Tipo: string | null Formato: date-time
      obbligatorio

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

    • endpoint
      Tipo: string | null
      obbligatorio

      Identificatore dell'operazione del provider; usa il percorso del job Felo documentato per il polling.

    • error
      Tipo: object | null
      obbligatorio
      • code
        Tipo: string | null
      • message
        Tipo: string | null
    • id
      Tipo: string | null
      obbligatorio
    • object
      const:  
      integration_async_job
      obbligatorio
    • output
      obbligatorio
    • pricing
      Tipo: object | null
      obbligatorio

      Metadati di autorizzazione e regolamento del provider in micro-USD; non sono un saldo, un blocco o una ricevuta di fatturazione Felo.

      • authorizedMicrosUSD
        Tipo: integer | null

        Integer numbers.

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

        Integer numbers.

    • status
      Tipo: string enum
      obbligatorio
      valori
      • queued
      • running
      • completed
      • failed
      • cancelled
    • outputExpired
      Tipo: boolean | null
    application/json
  • 400

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    L'operazione non è riuscita. Conserva l'ID richiesta della risposta quando contatti il supporto 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.