# Thiết lập API Felo

Thiết lập các endpoint Felo trong Data API để tìm kiếm, nội dung web, dữ liệu X và bản trình bày, bằng số dư nền tảng.

Felo là một nhà cung cấp trong [Data API](https://openapi.felo.ai/vi/docs/data-api), cung cấp tìm kiếm web, đọc web, dữ liệu X, câu trả lời dựa trên tìm kiếm và bản trình bày. Tìm từng endpoint Felo bên cạnh các nhà cung cấp khác trong danh mục Data API tương ứng.

Các endpoint này sử dụng **số dư nền tảng** và tiền tố `/api/v1/data`. Hướng dẫn này giải thích xác thực, yêu cầu đầu tiên của bạn và nơi tìm các quy tắc thanh toán.

Để dùng tín dụng Felo Pro, xem [Felo APIs hiện có](https://openapi.felo.ai/vi/docs/api-reference/felo-apis.md). Số dư nền tảng và tín dụng Pro là tách biệt.

## Thực hiện yêu cầu đầu tiên của bạn

1. Tạo một khóa trong [Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. Kiểm tra hoặc nạp thêm **số dư nền tảng** của bạn trong [Console → Billing](https://openapi.felo.ai/console/billing).
3. Đặt khóa trên máy chủ của bạn hoặc trong shell cục bộ:

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

Gửi `Authorization: Bearer $FELO_API_KEY`. `X-API-Key` cũng được chấp nhận; hãy chọn một phương thức xác thực. Yêu cầu JSON cần `Content-Type: application/json`.

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What is retrieval augmented generation?","count":3}'
```

HTTP 200 trả về một mảng `resources` với tiêu đề trang, liên kết và đoạn trích, cùng `total`. Nó không tạo ra một câu trả lời hội thoại; hãy dùng [Chat](https://openapi.felo.ai/vi/docs/data-api/guides/felo-chat.md) cho việc đó.

## Khám phá các API

| Hướng dẫn | Thao tác | Bạn nhận được gì | Đơn vị tính phí |
|---|---|---|---|
| [Tìm kiếm Web](https://openapi.felo.ai/vi/docs/data-api/guides/felo-web-search.md) | Tìm kiếm web | Tiêu đề trang, liên kết và đoạn trích | Yêu cầu |
| [Đọc Web](https://openapi.felo.ai/vi/docs/data-api/guides/felo-web-read.md) | Đọc một URL | Markdown, văn bản, HTML hoặc ảnh chụp màn hình | Yêu cầu |
| [Dữ liệu X](https://openapi.felo.ai/vi/docs/data-api/guides/felo-x-data.md) | Hồ sơ, tìm kiếm người dùng, bài đăng của người dùng, tìm kiếm bài đăng, phản hồi | Người dùng và bài đăng có cấu trúc, với phân trang khi được hỗ trợ | Kết quả trả về |
| [Trò chuyện dựa trên tìm kiếm](https://openapi.felo.ai/vi/docs/data-api/guides/felo-chat.md) | Trả lời một câu hỏi | Câu trả lời và nguồn web | Yêu cầu |
| [PPT](https://openapi.felo.ai/vi/docs/data-api/guides/felo-ppt.md) | Tạo, trạng thái, kết quả, xuất, trạng thái xuất, xóa | Tác vụ tạo và PPTX có thể tải xuống | Trang được tạo; xuất tính phí riêng |
| [Thanh toán và Lỗi](https://openapi.felo.ai/vi/docs/data-api/guides/felo-billing.md) | Hướng dẫn tích hợp dùng chung | Giá, xử lý số dư và quy tắc thử lại | — |

Có **14 thao tác cốt lõi** trong các hướng dẫn này. Nếu việc tạo PPT trả về `stream_key`, [hướng dẫn PPT](https://openapi.felo.ai/vi/docs/data-api/guides/felo-ppt.md#c-s-ki-n-t-o-b-ng-sse) cũng giải thích cách đọc các sự kiện tạo qua SSE. Các truy vấn trạng thái và kết quả, truy vấn trạng thái xuất và thao tác xóa không tạo ra phí mới.

## Trước khi chuyển một tích hợp hiện có

Hãy dùng đúng hướng dẫn cho endpoint bạn gọi. Chỉ thay `/v2` bằng `/api/v1/data` thì chưa phải là một quá trình di chuyển hoàn chỉnh:

- Web Read dùng `/web/read`, với một định dạng đầu ra cho mỗi yêu cầu.
- Chat trả về `status: "ok"`; nó chỉ hỗ trợ JSON không streaming.
- Kết quả PPT dùng **POST** `/tasks/{task_id}/historical`.
- Việc tạo PPT trả về các định danh ở gốc JSON. Lưu cả `task_id` và `ppt_business_id`.
- Các PPT được tạo sẽ hết hạn sau bảy ngày. Hãy xuất và lưu tệp của bạn trước khi hết hạn.

Ở đây không có tài liệu về tương đương OpenAPI gốc cho mọi quy trình `/v2`, chẳng hạn như CRUD LiveDoc, Mindmap hoặc SuperAgent. Tiếp tục dùng [hướng dẫn Felo APIs](https://openapi.felo.ai/vi/docs/api-reference/felo-apis.md) và thanh toán bằng tín dụng Pro.

## Hợp đồng và giá hiện tại

- [Lược đồ OpenAPI đã công bố](https://openapi.felo.ai/api/v1/data/openapi.json) — định nghĩa trường và lược đồ phản hồi.
- [Lược đồ OpenAPI YAML](https://openapi.felo.ai/api/v1/data/openapi.yaml) — cho các công cụ chấp nhận YAML.
- [Giá hiện tại](https://openapi.felo.ai/api/v1/data/prices) — mã thao tác, đơn vị tính phí và mức giá hiện tại.

Các tài nguyên này là công khai và có thể đọc mà không cần khóa. Xem [Thanh toán và Lỗi](https://openapi.felo.ai/vi/docs/data-api/guides/felo-billing.md) trước khi thêm cơ chế thử lại tự động.