Hướng dẫn
Tổng quan nền tảng
Xem Model API, Data API và Felo APIs phối hợp với nhau thế nào và nên bắt đầu từ đâu.
Felo API Platform cung cấp cho bạn một khóa API cho ba bề mặt yêu cầu khác nhau. Chúng dùng chung tài khoản, tín dụng và khóa, nhưng giải quyết các vấn đề khác nhau và dùng base URL khác nhau.
Ba bề mặt
| Bề mặt | Base URL | Dùng cho | Tham chiếu |
|---|---|---|---|
| Model API | https://openapi.felo.ai/api/v1 (tương thích OpenAI) và https://openapi.felo.ai/api (tương thích Anthropic) | Gọi trực tiếp mô hình ngôn ngữ, hình ảnh, video hoặc quyết định | Model API |
| Data API | https://openapi.felo.ai/v1/beta | Gọi các nhà cung cấp dữ liệu và tìm kiếm bên thứ ba có tên | Data API |
| Felo API | https://openapi.felo.ai/v2 | Dùng các quy trình tìm kiếm, văn phòng, nội dung, trích xuất và tri thức của chính Felo | Tham chiếu Felo API |
Tôi nên dùng bề mặt nào?
| Tôi muốn… | Dùng |
|---|---|
| Chạy LLM từ mã của riêng tôi hoặc một công cụ viết mã AI | Model API |
| Nhận câu trả lời kèm tìm kiếm web, trích dẫn và phân tích truy vấn | Chat API (/v2/chat) |
| Tạo bộ slide, landing page, mindmap hoặc video | Tác vụ Felo hoặc endpoint mô hình tương ứng |
| Xây dựng cơ sở tri thức và truy xuất từ đó | LiveDoc API |
| Gọi Tavily, Exa, Apollo hoặc một nhà cung cấp dữ liệu có tên khác | Data API |
| Ghim một mô hình vào một nhà cung cấp thượng nguồn cụ thể | Model API với X-Felo-Channel |
Thiết lập chung
- Tạo một khóa API trong Felo API Platform console.
- Gửi khóa dưới dạng
Authorization: Bearer $FELO_API_KEY. - Nạp tín dụng dịch vụ định giá bằng USD khi bạn sử dụng nền tảng.
- Chọn base URL cho bề mặt bạn đang gọi.
Cùng một khóa hoạt động trên các bề mặt được ghi ở đây. Hãy dùng khóa riêng cho từng môi trường để có thể xoay vòng một khóa mà không làm gián đoạn khóa kia.
Những gì nền tảng bổ sung
- Một khóa thay vì một tài khoản riêng với từng nhà cung cấp mô hình và dữ liệu.
- Danh mục mô hình được công bố với model ID, giới hạn ngữ cảnh, giao thức và mức giá.
- Giá nhà cung cấp được công bố cho các mô hình có sẵn qua nhiều hơn một kênh.
- Hợp nhất mức sử dụng và thanh toán trong một console.
Các bước tiếp theo
- Mô hình và giá — đọc danh mục và ước tính một yêu cầu.
- Kênh và định tuyến nhà cung cấp — ghim một mô hình vào một nhà cung cấp.
- Giao thức và SDK — chọn giữa tương thích OpenAI, Responses và Messages.
- Tác vụ bất đồng bộ — xử lý các tác vụ PPT, landing page, video và xuất.
- Tổng quan Data API — gọi các endpoint bên thứ ba qua tiền tố chung.