# Nastavení Felo API

Nastavte koncové body Felo v Data API pro vyhledávání, webový obsah, data X a prezentace pomocí zůstatku platformy.

Felo je jedním z poskytovatelů v [Data API](https://openapi.felo.ai/cs/docs/data-api) a nabízí webové vyhledávání, čtení webu, data X, odpovědi založené na vyhledávání a prezentace. Každý koncový bod Felo najdete spolu s ostatními poskytovateli v příslušné kategorii Data API.

Tyto koncové body používají **zůstatek platformy** a prefix `/api/v1/data`. Tento průvodce vysvětluje autentizaci, váš první požadavek a kde najít pravidla účtování.

Chcete-li používat Felo Pro credits, podívejte se na [existující Felo APIs](https://openapi.felo.ai/cs/docs/api-reference/felo-apis.md). Zůstatek platformy a Pro credits jsou oddělené.

## Vytvořte svůj první požadavek

1. Vytvořte klíč v [Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. Zkontrolujte nebo doplňte svůj **zůstatek platformy** v [Console → Billing](https://openapi.felo.ai/console/billing).
3. Nastavte klíč na svém serveru nebo v místním shellu:

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

Pošlete `Authorization: Bearer $FELO_API_KEY`. `X-API-Key` je také podporován; zvolte jednu metodu autentizace. JSON požadavky vyžadují `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 vrací pole `resources` s názvy stránek, odkazy a úryvky, plus `total`. Nevytváří konverzační odpověď; pro to použijte [Chat](https://openapi.felo.ai/cs/docs/data-api/guides/felo-chat.md).

## Prozkoumejte API

| Průvodce | Operace | Co dostanete | Účtovací jednotka |
|---|---|---|---|
| [Web Search](https://openapi.felo.ai/cs/docs/data-api/guides/felo-web-search.md) | Vyhledávání na webu | Názvy stránek, odkazy a úryvky | Požadavek |
| [Web Read](https://openapi.felo.ai/cs/docs/data-api/guides/felo-web-read.md) | Čtení URL | Markdown, text, HTML nebo snímek obrazovky | Požadavek |
| [X Data](https://openapi.felo.ai/cs/docs/data-api/guides/felo-x-data.md) | Profily, vyhledávání uživatelů, příspěvky uživatelů, vyhledávání příspěvků, odpovědi | Strukturovaní uživatelé a příspěvky, s stránkováním tam, kde je podporováno | Vrácený výsledek |
| [Search-grounded Chat](https://openapi.felo.ai/cs/docs/data-api/guides/felo-chat.md) | Odpověď na otázku | Odpověď a webové zdroje | Požadavek |
| [PPT](https://openapi.felo.ai/cs/docs/data-api/guides/felo-ppt.md) | Vytvoření, stav, výsledky, export, stav exportu, smazání | Generovací úloha a stahovatelný PPTX | Vygenerovaná stránka; export se účtuje samostatně |
| [Billing and Errors](https://openapi.felo.ai/cs/docs/data-api/guides/felo-billing.md) | Sdílené integrační pokyny | Ceny, práce se zůstatkem a pravidla opakování | — |

V těchto průvodcích je celkem **14 základních operací**. Pokud vytvoření PPT vrátí `stream_key`, [průvodce PPT](https://openapi.felo.ai/cs/docs/data-api/guides/felo-ppt.md#ten-ud-lost-generov-n-pomoc-sse) také vysvětluje, jak číst události generování pomocí SSE. Dotazy na stav a výsledek, dotazy na stav exportu a smazání nevytvářejí nový poplatek.

## Než přesunete stávající integraci

Použijte průvodce pro přesný koncový bod, který voláte. Nahrazení `/v2` za `/api/v1/data` není kompletní migrace:

- Web Read používá `/web/read`, s jedním výstupním formátem na požadavek.
- Chat vrací `status: "ok"`; podporuje pouze ne-streamované JSON.
- Výsledky PPT používají **POST** `/tasks/{task_id}/historical`.
- Vytvoření PPT vrací identifikátory v kořeni JSON. Uložte jak `task_id`, tak `ppt_business_id`.
- Vygenerované PPT vyprší po sedmi dnech. Exportujte a uložte soubor před vypršením.

Zde není zdokumentována žádná nativní OpenAPI alternativa pro každý pracovní postup `/v2`, například CRUD LiveDoc, Mindmap nebo SuperAgent. Pokračujte v používání jejich [průvodců Felo APIs](https://openapi.felo.ai/cs/docs/api-reference/felo-apis.md) a účtování pomocí Pro credits.

## Smlouva a aktuální ceny

- [Publikované schéma OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json) — definice polí a schémata odpovědí.
- [Schéma OpenAPI ve formátu YAML](https://openapi.felo.ai/api/v1/data/openapi.yaml) — pro nástroje, které přijímají YAML.
- [Aktuální ceny](https://openapi.felo.ai/api/v1/data/prices) — ID operací, účtovací jednotky a aktuální sazby.

Tyto zdroje jsou veřejné a lze je číst bez klíče. Před přidáním automatického opakování se podívejte na [Účtování a chyby](https://openapi.felo.ai/cs/docs/data-api/guides/felo-billing.md).