Felo API PlatformFelo API Platform
Všechny endpointy Exa
v0.2.0-beta
OpenAPI 3.1.0

Odešle asynchronní spuštění výzkumného agenta.

Server:https://openapi.felo.ai
Klientské knihovny

Exa

​

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

Odešle asynchronní spuštění výzkumného agenta.

​

Odešle asynchronní výzkumnou úlohu. Zadejte query; volitelně systemPrompt a effort (pouze minimal). Idempotency-Key je povinný. HTTP 202 vrací úlohu; použijte její id s odpovídajícím Felo endpointem pro dotazování, dokud úloha neskončí jako dokončená, neúspěšná nebo zrušená. Cenová pole úlohy jsou metadata autorizace a vypořádání poskytovatele, nikoli fakturační záznamy Felo.

Cenová reference

  • Účtování: reference pevného požadavku.
  • Referenční odhad požadavku: USD 0.1.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Hlavičky
  • Idempotency-Key
    Typ: string
    povinné

    Délka v UTF-8 po oříznutí musí být 1 až 191 bajtů.

Tělo
povinné
application/json
  • query
    Typ: string
    povinné

    Neprázdné query po oříznutí bílých znaků.

  • effort
    Typ: string | null enum

    Podporována je pouze hodnota minimal parametru effort; vynechané, prázdné a null hodnoty se normalizují na minimal.

    hodnoty
    • null
    • minimal
  • systemPrompt
    Typ: string | null
Odpovědi
  • 202
    Typ: object

    Úspěch

    • completedAt
      Typ: string | null Formát: date-time
      povinné

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

    • createdAt
      Typ: string | null Formát: date-time
      povinné

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

    • endpoint
      Typ: string | null
      povinné

      Identifikátor operace poskytovatele; k dotazování používejte dokumentovanou cestu úlohy Felo.

    • error
      Typ: object | null
      povinné
      • code
        Typ: string | null
      • message
        Typ: string | null
    • id
      Typ: string | null
      povinné
    • object
      const:  
      integration_async_job
      povinné
    • output
      povinné
    • pricing
      Typ: object | null
      povinné

      Metadata autorizace a vypořádání poskytovatele v mikro-USD; nikoli zůstatek Felo, blokace ani fakturační doklad.

      • authorizedMicrosUSD
        Typ: integer | null

        Integer numbers.

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

        Integer numbers.

    • status
      Typ: string enum
      povinné
      hodnoty
      • queued
      • running
      • completed
      • failed
      • cancelled
    • outputExpired
      Typ: boolean | null
    application/json
  • 400

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Operace selhala. Při kontaktu s podporou Felo si ponechte ID požadavku z odpovědi.

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.