# Felo APIs 總覽

Felo workflows under /v2, called with Felo Pro credits. Compare them with platform-balance APIs.

若要以 **平台餘額** 支付網頁搜尋、網頁讀取、X 資料、Chat 或 PPT，請使用 [Data API 中的 Felo](https://openapi.felo.ai/zh-TW/docs/api-reference/openapi/overview.md)。本頁說明現有的 `/v2` APIs，它們使用 **Felo Pro 點數**。

Felo APIs 是第一方、工作流程層級的 API，適用於搜尋、文件、簡報、網頁擷取、社群搜尋與代理人工作流程。它們使用與平台其他部分相同的 Felo API 金鑰，但計費與模型呼叫分開。

::: tip Felo Pro 訂閱點數
**Felo APIs 目前接受 Felo Pro 訂閱點數。** 這適用於本節中的第一方 `/v2` APIs：Felo Search、PPT Task、Mindmap、LiveDoc、Web Fetch、X Search、YouTube Subtitling、Landing Page 與 SuperAgent。

這**不適用**於 Model API 呼叫（`/api/v1`）。Model API 呼叫需要預付的 Felo API Platform 服務點數；Felo Pro 訂閱點數不能用於這些呼叫。
:::

資格可能變動。[Console Billing](https://openapi.felo.ai/console/billing) 頁面是你目前餘額與用量的唯一準據。

## 本節中的 APIs

| API | 端點 | 用途 |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/zh-TW/docs/api-reference/chat.md) | `POST /v2/chat` | 具備查詢分析、來源與引用的對話式網頁搜尋 |
| [PPT Task API](https://openapi.felo.ai/zh-TW/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | 生成投影片與輪詢任務狀態 |
| [Mindmap API](https://openapi.felo.ai/zh-TW/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | 將提示詞或 LiveDoc 內容轉為心智圖 |
| [LiveDoc API](https://openapi.felo.ai/zh-TW/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | 建立知識庫、管理資源與擷取內容 |
| [Web Fetch API](https://openapi.felo.ai/zh-TW/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | 將網頁擷取為 HTML、文字或 Markdown |
| [X Search API](https://openapi.felo.ai/zh-TW/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | 搜尋 X 使用者、推文、時間軸與回覆 |
| [YouTube Subtitling API](https://openapi.felo.ai/zh-TW/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | 取得 YouTube 字幕與時間戳 |
| [Landing Page Task API](https://openapi.felo.ai/zh-TW/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | 非同步生成登陸頁 |
| [SuperAgent API](https://openapi.felo.ai/zh-TW/docs/api-reference/superagent.md) | `POST /v2/conversations` | 透過 SSE 執行代理人對話 |

## 驗證與第一個呼叫

在 [Console → API Keys](https://openapi.felo.ai/console/api-keys) 建立一組 Felo API 金鑰，並將其作為 Bearer 權杖送出。

```bash
export FELO_API_KEY="YOUR_API_KEY"

curl -sS https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What are the latest AI agent trends?"}'
```

成功回應會包含答案、查詢分析與附引用的網頁資源。

## 計費模型

| 介面 | 路徑 | 呼叫如何付費 |
|---|---|---|
| Felo APIs | `/v2/*` | Felo Pro 點數 |
| [Data API 中的 Felo](https://openapi.felo.ai/zh-TW/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | 平台餘額，不是 Pro 點數 |
| Model API | `/api/v1/*` | 僅能使用預付的 Felo API Platform 服務點數；Felo Pro 不適用 |
| Data API | `/v1/beta/*` | 依 API 目錄中各端點所示的計費基準計算 |

Felo Pro 點數與 API 服務點數是不同的餘額。Felo Pro 訂閱不會自動提供 API 服務點數，而 API 服務點數也不會額外增加 Felo Pro 訂閱點數。

## 相關內容

- [Felo Search API](https://openapi.felo.ai/zh-TW/docs/api-reference/chat.md)
- [計費與點數](https://openapi.felo.ai/zh-TW/docs/faq/billing-and-credits.md)
- [錯誤、限制與重試](https://openapi.felo.ai/zh-TW/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)