Felo API PlatformFelo API Platform

指南

Data API 總覽

透過統一前綴呼叫第三方介面，並保持一致的鑑權和請求處理方式。

Data API 是以一個 Felo key 存取第三方 API 的目錄。它與 Felo 自有的 /v2 APIs 以及 Model API 分開。

共用前綴

https://openapi.felo.ai/v1/beta

參考文件把每個 endpoint 顯示為以 /v1/beta 開頭的完整路徑。在 host 上原樣使用該路徑；不要再次加上共用前綴。例如 Tavily 搜尋 endpoint 是：

POST https://openapi.felo.ai/v1/beta/tavily/search

尋找 endpoint

  • 依供應商瀏覽API 目錄。
  • 開啟 Data API 參考 查看完整 endpoint 清單、參數與回應 schema。
  • 使用參考文件的 tags 在供應商之間移動。

每個供應商保留自己的請求形狀。共用層只統一認證與路由，不統一 payload。送出請求前請先讀 endpoint schema。

認證

使用其中一個標頭：

Authorization: Bearer $FELO_API_KEY

或：

X-API-Key: $FELO_API_KEY

JSON 內容請送出 Content-Type: application/json。

範例請求

curl https://openapi.felo.ai/v1/beta/tavily/search \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is Felo AI?",
    "max_results": 3
  }'

回應形狀由供應商決定。結果、分頁游標與 metadata 等欄位不會在不同供應商之間統一。

慣例

主題預期情況
Payload供應商專屬 JSON；請遵循 endpoint schema
分頁欄位名稱與游標樣式因 endpoint 而異
錯誤包含 status、code、message 與 request_id 的 JSON；供應商細節可能出現在 message 中
限流依 endpoint 與供應商而異；高負載時預期 429
計費每次呼叫計費，與 Model API 共用同一份服務額度

錯誤處理

認證失敗會回傳與平台其餘部分相同的封裝：

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid API Key",
  "request_id": "..."
}

若為供應商層級的失敗，請讀 HTTP 狀態與 message。記錄 method、完整路徑、請求內容形狀與 request_id。不要記錄完整的 API key。

重試

對 429 與 5xx 回應以退避方式重試。400 或 401 不要原樣重試。部分供應商操作不適合重複執行；重試寫入操作前請先確認 endpoint。

何時改用 Felo API

需要特定的第三方資料來源時使用 Data API。想要 Felo 自己的工作流程時使用 Felo API：

相關