Thiết lập API Felo
Nhà cung cấp: Felo · Thanh toán bằng số dư nền tảng
Felo là một nhà cung cấp trong 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ó. 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
- Tạo một khóa trong Console → API Keys.
- Kiểm tra hoặc nạp thêm số dư nền tảng của bạn trong Console → Billing.
- Đặt khóa trên máy chủ của bạn hoặc trong shell cục bộ:
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.
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 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 | Tìm kiếm web | Tiêu đề trang, liên kết và đoạn trích | Yêu cầu |
| Đọc Web | Đọ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 | 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 | Trả lời một câu hỏi | Câu trả lời và nguồn web | Yêu cầu |
| PPT | 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 | 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 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_idvà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 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ố — định nghĩa trường và lược đồ phản hồi.
- Lược đồ OpenAPI YAML — cho các công cụ chấp nhận YAML.
- Giá hiện tại — 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 trước khi thêm cơ chế thử lại tự động.