# Tổng quan Felo APIs

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

Để thanh toán cho tìm kiếm web, đọc web, dữ liệu X, Chat hoặc PPT bằng **số dư nền tảng**, hãy dùng [Felo trong Data API](https://openapi.felo.ai/vi/docs/api-reference/openapi/overview.md). Trang này tài liệu hóa các API `/v2` hiện có, vốn sử dụng **tín dụng Felo Pro**.

Felo APIs là các API first-party, ở cấp quy trình, cho tìm kiếm, tài liệu, bản trình bày, trích xuất web, tìm kiếm xã hội và quy trình agent. Chúng dùng cùng Felo API key như phần còn lại của nền tảng, nhưng được tính phí riêng biệt với các cuộc gọi model.

::: tip Tín dụng thuê bao Felo Pro
**Felo APIs hiện chấp nhận tín dụng thuê bao Felo Pro.** Điều này áp dụng cho các API `/v2` first-party trong mục này: Felo Search, PPT Task, Mindmap, LiveDoc, Web Fetch, X Search, YouTube Subtitling, Landing Page và SuperAgent.

Điều này **không** áp dụng cho các cuộc gọi Model API (`/api/v1`). Các cuộc gọi model yêu cầu tín dụng dịch vụ Felo API Platform trả trước; tín dụng thuê bao Felo Pro không thể dùng cho chúng.
:::

Điều kiện đủ điều kiện có thể thay đổi. Trang [Console Billing](https://openapi.felo.ai/console/billing) là nguồn sự thật cho số dư và mức sử dụng hiện tại của bạn.

## Các API trong mục này

| API | Endpoint | Dùng cho |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/vi/docs/api-reference/chat.md) | `POST /v2/chat` | Tìm kiếm web hội thoại với phân tích truy vấn, nguồn và trích dẫn |
| [PPT Task API](https://openapi.felo.ai/vi/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | Tạo bộ slide và thăm dò trạng thái tác vụ |
| [Mindmap API](https://openapi.felo.ai/vi/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | Chuyển prompt hoặc ngữ cảnh LiveDoc thành mindmap |
| [LiveDoc API](https://openapi.felo.ai/vi/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | Tạo cơ sở tri thức, quản lý tài nguyên và truy xuất ngữ cảnh |
| [Web Fetch API](https://openapi.felo.ai/vi/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | Trích xuất một trang web dưới dạng HTML, văn bản hoặc Markdown |
| [X Search API](https://openapi.felo.ai/vi/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | Tìm kiếm người dùng X, tweet, dòng thời gian và phản hồi |
| [YouTube Subtitling API](https://openapi.felo.ai/vi/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | Lấy phụ đề YouTube và dấu thời gian |
| [Landing Page Task API](https://openapi.felo.ai/vi/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | Tạo landing page không đồng bộ |
| [SuperAgent API](https://openapi.felo.ai/vi/docs/api-reference/superagent.md) | `POST /v2/conversations` | Chạy hội thoại agent qua SSE |

## Xác thực và cuộc gọi đầu tiên

Tạo một API key Felo trong [Console → API Keys](https://openapi.felo.ai/console/api-keys) và gửi nó dưới dạng Bearer token.

```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?"}'
```

Một phản hồi thành công bao gồm câu trả lời, phân tích truy vấn và các tài nguyên web được trích dẫn.

## Mô hình thanh toán

| Giao diện | Đường dẫn | Cách tính phí |
|---|---|---|
| Felo APIs | `/v2/*` | Tín dụng Felo Pro |
| [Felo trong Data API](https://openapi.felo.ai/vi/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | Số dư nền tảng, không phải tín dụng Pro |
| Model API | `/api/v1/*` | Chỉ dùng tín dụng dịch vụ Felo API Platform trả trước; Felo Pro không áp dụng |
| Data API | `/v1/beta/*` | Dùng cơ sở thanh toán của danh mục API được hiển thị cho từng endpoint |

Tín dụng Felo Pro và tín dụng dịch vụ API là các số dư riêng biệt. Một thuê bao Felo Pro không tự động cấp tín dụng dịch vụ API, và tín dụng dịch vụ API không thêm tín dụng thuê bao Felo Pro.

## Liên quan

- [Felo Search API](https://openapi.felo.ai/vi/docs/api-reference/chat.md)
- [Thanh toán và Tín dụng](https://openapi.felo.ai/vi/docs/faq/billing-and-credits.md)
- [Lỗi, Giới hạn và Thử lại](https://openapi.felo.ai/vi/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)