Felo API PlatformFelo API Platform
Semua endpoint Exa
v0.2.0-beta
OpenAPI 3.1.0

Kirim proses Agent riset asinkron.

Server:https://openapi.felo.ai
Pustaka Klien

Exa

​

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

Kirim proses Agent riset asinkron.

​

Kirim tugas riset asinkron. Sediakan query; opsional systemPrompt dan effort (hanya minimal). Idempotency-Key wajib. HTTP 202 mengembalikan tugas; gunakan id-nya dengan endpoint polling Felo yang sesuai hingga completed, failed, atau cancelled. Field harga tugas adalah metadata otorisasi dan penyelesaian penyedia, bukan catatan tagihan Felo.

Referensi harga

  • Metering: Referensi permintaan tetap.
  • Estimasi referensi per permintaan: USD 0.1.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Header
  • Idempotency-Key
    Tipe: string
    wajib

    Panjang UTF-8 setelah dipangkas harus 1 hingga 191 byte.

Isi
wajib
application/json
  • query
    Tipe: string
    wajib

    Kueri tidak kosong setelah spasi dipangkas.

  • effort
    Tipe: string | null enum

    Hanya upaya minimal yang didukung; nilai yang dihilangkan, kosong, dan null dinormalisasi menjadi minimal.

    nilai
    • null
    • minimal
  • systemPrompt
    Tipe: string | null
Respons
  • 202
    Tipe: object

    Berhasil

    • completedAt
      Tipe: string | null Format: date-time
      wajib

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

    • createdAt
      Tipe: string | null Format: date-time
      wajib

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

    • endpoint
      Tipe: string | null
      wajib

      Pengenal operasi penyedia; gunakan jalur tugas Felo yang didokumentasikan untuk polling.

    • error
      Tipe: object | null
      wajib
      • code
        Tipe: string | null
      • message
        Tipe: string | null
    • id
      Tipe: string | null
      wajib
    • object
      const:  
      integration_async_job
      wajib
    • output
      wajib
    • pricing
      Tipe: object | null
      wajib

      Metadata otorisasi dan penyelesaian penyedia dalam micro-USD; bukan saldo Felo, penahanan, atau tanda terima tagihan.

      • authorizedMicrosUSD
        Tipe: integer | null

        Integer numbers.

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

        Integer numbers.

    • status
      Tipe: string enum
      wajib
      nilai
      • queued
      • running
      • completed
      • failed
      • cancelled
    • outputExpired
      Tipe: boolean | null
    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Operasi gagal. Simpan ID permintaan respons saat menghubungi dukungan 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.