Felo API PlatformFelo API Platform
全部 Exa 端點
v0.2.0-beta
OpenAPI 3.1.0

提交非同步研究 Agent 執行。

伺服器:https://openapi.felo.ai
用戶端程式庫

Exa

​

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

提交非同步研究 Agent 執行。

​

提交非同步研究任務。提供 query;可選提供 systemPrompt 與 effort(僅支援 minimal)。Idempotency-Key 為必填。HTTP 202 傳回一個任務;以其 id 呼叫對應的 Felo 輪詢端點,直到狀態為 completed、failed 或 cancelled。任務的價格欄位屬於供應商授權與結算中繼資料,並非 Felo 計費記錄。

計費參考

  • 計量方式:固定請求計費的參考值。
  • 參考請求估算: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
      必填

      以微美元計的供應商授權與結算中繼資料;不是 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

    需要有效的 Felo API 金鑰。

  • 402

    由於未符合計費要求,要求無法繼續。

  • 403

    該帳戶無權執行此操作。

  • 429

    已達到要求或支出上限。

  • 502

    服務無法完成該要求。

  • 503

    API 或計費服務暫時無法使用。

  • 504

    服務在處理要求時逾時。

  • default

    操作失敗。聯絡 Felo 支援時請保留回應的請求 ID。

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.

需要協助嗎?