# Konfiguracja Felo API

Skonfiguruj punkty końcowe Felo w Data API do wyszukiwania, treści internetowych, danych X i prezentacji, używając salda platformy.

Felo jest jednym z dostawców w [Data API](https://openapi.felo.ai/pl/docs/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](https://openapi.felo.ai/pl/docs/api-reference/felo-apis.md). Saldo platformy i kredyty Pro są oddzielne.

## Złóż pierwsze żądanie

1. Utwórz klucz w [Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. Sprawdź lub doładuj swoje **saldo platformy** w [Console → Billing](https://openapi.felo.ai/console/billing).
3. Ustaw klucz na swoim serwerze lub w lokalnej powłoce:

```bash
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`.

```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 zwraca tablicę `resources` z tytułami stron, linkami i fragmentami oraz `total`. Nie generuje to rozmownej odpowiedzi; do tego użyj [Chat](https://openapi.felo.ai/pl/docs/data-api/guides/felo-chat.md).

## Poznaj API

| Przewodnik | Operacje | Co otrzymujesz | Jednostka rozliczeniowa |
|---|---|---|---|
| [Wyszukiwanie w sieci](https://openapi.felo.ai/pl/docs/data-api/guides/felo-web-search.md) | Wyszukaj w sieci | Tytuły stron, linki i fragmenty | Żądanie |
| [Odczyt strony internetowej](https://openapi.felo.ai/pl/docs/data-api/guides/felo-web-read.md) | Odczytaj URL | Markdown, tekst, HTML lub zrzut ekranu | Żądanie |
| [Dane X](https://openapi.felo.ai/pl/docs/data-api/guides/felo-x-data.md) | 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](https://openapi.felo.ai/pl/docs/data-api/guides/felo-chat.md) | Odpowiedz na pytanie | Odpowiedź i źródła internetowe | Żądanie |
| [PPT](https://openapi.felo.ai/pl/docs/data-api/guides/felo-ppt.md) | Tworzenie, status, wyniki, eksport, status eksportu, usuwanie | Zadanie generowania i możliwy do pobrania PPTX | Wygenerowana strona; eksport rozliczany osobno |
| [Rozliczenia i błędy](https://openapi.felo.ai/pl/docs/data-api/guides/felo-billing.md) | 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](https://openapi.felo.ai/pl/docs/data-api/guides/felo-ppt.md#odczyt-zdarze-generowania-z-sse) 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 i `ppt_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](https://openapi.felo.ai/pl/docs/api-reference/felo-apis.md) oraz rozliczania z kredytów Pro.

## Kontrakt i bieżące ceny

- [Opublikowany schemat OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json) — definicje pól i schematy odpowiedzi.
- [Schemat OpenAPI w YAML](https://openapi.felo.ai/api/v1/data/openapi.yaml) — dla narzędzi akceptujących YAML.
- [Bieżące ceny](https://openapi.felo.ai/api/v1/data/prices) — identyfikatory operacji, jednostki rozliczeniowe i aktualne stawki.

Te zasoby są publiczne i można je odczytać bez klucza. Zobacz [Rozliczenia i błędy](https://openapi.felo.ai/pl/docs/data-api/guides/felo-billing.md) przed dodaniem automatycznych ponowień.