指南
平台總覽
了解 Model API、Data API 與 Felo APIs 三層如何分工，以及該從哪一層開始。
Felo API Platform 用一個 API key 涵蓋三種不同的請求層。它們共用同一個帳號、額度與 key，但解決不同問題，使用不同的 base URL。
三種 API 層
| API 層 | Base URL | 適用情境 | 參考 |
|---|---|---|---|
| Model API | https://openapi.felo.ai/api/v1（OpenAI-compatible）與 https://openapi.felo.ai/api（Anthropic-compatible） | 直接呼叫語言、圖像、影片或決策模型 | Model API |
| Data API | https://openapi.felo.ai/v1/beta | 呼叫具名的第三方資料與搜尋供應商 | Data API |
| Felo APIs | https://openapi.felo.ai/v2 | 使用 Felo 自有的搜尋、辦公、內容、擷取與知識工作流程 | Felo API 參考 |
該用哪一種 API 層？
| 我想要… | 使用 |
|---|---|
| 從自己的程式或 AI 程式開發工具執行 LLM | Model API |
| 取得附帶網頁搜尋、引用與查詢分析的回答 | Chat API（/v2/chat） |
| 產生簡報、落地頁、心智圖或影片 | 對應的 Felo 任務或模型 endpoint |
| 建立知識庫並從中檢索 | LiveDoc API |
| 呼叫 Tavily、Exa、Apollo 或其他具名資料供應商 | Data API |
| 把模型固定到指定的上游供應商 | 搭配 X-Felo-Channel 的 Model API |
共用設定
- 在 Felo API Platform 主控台建立一個 API key。
- 以
Authorization: Bearer $FELO_API_KEY傳送。 - 依使用量儲值以美元計價的服務額度。
- 選擇要呼叫的 API 層對應的 base URL。
同一個 key 可用於本文件涵蓋的所有 API 層。不同環境請使用不同的 key，這樣輪替其中一個時不會影響另一個。
平台額外提供什麼
- 一個 key，不必向每個模型與資料供應商分別註冊帳號。
- 公開的模型目錄，包含模型 ID、context 上限、協議與費率。
- 對可透過多個通道提供的模型，公開各供應商價格。
- 在主控台集中管理用量與計費。
後續步驟
- 模型與價格 — 讀懂目錄並估算一次請求。
- 通道與供應商路由 — 把模型固定到指定供應商。
- 協議與 SDK — 在 OpenAI-compatible、Responses 與 Messages 之間選擇。
- 非同步任務 — 處理 PPT、落地頁、影片與匯出工作。
- Data API 總覽 — 透過共用前綴呼叫第三方 endpoints。