Konfiguracja Felo API
Dostawca: Felo · Płatność z salda platformy
Felo jest jednym z dostawców w Data API, oferując wyszukiwanie w sieci, odczyt stron internetowych, dane X, odpowiedzi oparte na wyszukiwaniu oraz prezentacje. Każdy punkt końcowy Felo znajdziesz obok innych dostawców w odpowiedniej kategorii Data API.
Te punkty końcowe korzystają z salda platformy i prefiksu /api/v1/data. Ten przewodnik wyjaśnia uwierzytelnianie, pierwsze żądanie oraz gdzie znaleźć zasady rozliczeń.
Aby używać kredytów Felo Pro, zobacz istniejące Felo APIs. Saldo platformy i kredyty Pro są oddzielne.
Złóż pierwsze żądanie
- Utwórz klucz w Console → API Keys.
- Sprawdź lub doładuj swoje saldo platformy w Console → Billing.
- Ustaw klucz na swoim serwerze lub w lokalnej powłoce:
export FELO_API_KEY="YOUR_API_KEY"Wyślij Authorization: Bearer $FELO_API_KEY. X-API-Key jest również akceptowany; wybierz jedną metodę uwierzytelniania. Żądania JSON wymagają 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 zwraca tablicę resources z tytułami stron, linkami i fragmentami oraz total. Nie generuje to rozmownej odpowiedzi; do tego użyj Chat.
Poznaj API
| Przewodnik | Operacje | Co otrzymujesz | Jednostka rozliczeniowa |
|---|---|---|---|
| Wyszukiwanie w sieci | Wyszukaj w sieci | Tytuły stron, linki i fragmenty | Żądanie |
| Odczyt strony internetowej | Odczytaj URL | Markdown, tekst, HTML lub zrzut ekranu | Żądanie |
| Dane X | Profile, wyszukiwanie użytkowników, posty użytkowników, wyszukiwanie postów, odpowiedzi | Ustrukturyzowani użytkownicy i posty, z obsługą stronicowania tam, gdzie jest to wspierane | Zwrócony wynik |
| Chat oparty na wyszukiwaniu | Odpowiedz na pytanie | Odpowiedź i źródła internetowe | Żądanie |
| PPT | Tworzenie, status, wyniki, eksport, status eksportu, usuwanie | Zadanie generowania i możliwy do pobrania PPTX | Wygenerowana strona; eksport rozliczany osobno |
| Rozliczenia i błędy | Wspólne wskazówki integracyjne | Ceny, obsługa salda i zasady ponawiania prób | — |
W tych przewodnikach znajduje się łącznie 14 podstawowych operacji. Jeśli tworzenie PPT zwróci stream_key, przewodnik PPT wyjaśnia także, jak odczytywać zdarzenia generowania z SSE. Zapytania o status i wyniki, zapytania o status eksportu oraz usuwanie nie tworzą nowej opłaty.
Przed przeniesieniem istniejącej integracji
Użyj przewodnika dla dokładnego punktu końcowego, z którego korzystasz. Zastąpienie /v2 przez /api/v1/data nie jest pełną migracją:
- Web Read używa
/web/read, z jednym formatem wyjściowym na żądanie. - Chat zwraca
status: "ok"; obsługuje tylko JSON bez strumieniowania. - Wyniki PPT używają POST
/tasks/{task_id}/historical. - Tworzenie PPT zwraca identyfikatory w korzeniu JSON. Zapisz zarówno
task_id, jak ippt_business_id. - Wygenerowane PPT wygasają po siedmiu dniach. Wyeksportuj i zapisz plik przed wygaśnięciem.
Nie ma tu opisanej natywnej, równoważnej implementacji OpenAPI dla każdego przepływu /v2, takiego jak CRUD LiveDoc, Mindmap czy SuperAgent. Nadal używaj ich przewodników Felo APIs oraz rozliczania z kredytów Pro.
Kontrakt i bieżące ceny
- Opublikowany schemat OpenAPI — definicje pól i schematy odpowiedzi.
- Schemat OpenAPI w YAML — dla narzędzi akceptujących YAML.
- Bieżące ceny — identyfikatory operacji, jednostki rozliczeniowe i aktualne stawki.
Te zasoby są publiczne i można je odczytać bez klucza. Zobacz Rozliczenia i błędy przed dodaniem automatycznych ponowień.