# Налаштування Felo API

Налаштуйте кінцеві точки Felo в Data API для пошуку, вебконтенту, даних X і презентацій, використовуючи баланс платформи.

Felo — це один із провайдерів у [Data API](https://openapi.felo.ai/uk/docs/data-api), що пропонує вебпошук, читання вебсторінок, дані X, відповіді з прив’язкою до пошуку та презентації. Знаходьте кожну кінцеву точку Felo поруч з іншими провайдерами у відповідній категорії Data API.

Ці кінцеві точки використовують **баланс платформи** і префікс `/api/v1/data`. Цей посібник пояснює автентифікацію, ваш перший запит і де знайти правила білінгу.

Щоб використовувати кредити Felo Pro, дивіться [існуючі Felo APIs](https://openapi.felo.ai/uk/docs/api-reference/felo-apis.md). Баланс платформи та кредити Pro — це окремі речі.

## Зробіть свій перший запит

1. Створіть ключ у [Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. Перевірте або поповніть свій **баланс платформи** у [Console → Billing](https://openapi.felo.ai/console/billing).
3. Встановіть ключ на своєму сервері або в локальній оболонці:

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

Надсилайте `Authorization: Bearer $FELO_API_KEY`. `X-API-Key` також приймається; оберіть один спосіб автентифікації. Для JSON-запитів потрібен `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 повертає масив `resources` із заголовками сторінок, посиланнями та фрагментами, а також `total`. Це не генерує розмовну відповідь; для цього використовуйте [Chat](https://openapi.felo.ai/uk/docs/data-api/guides/felo-chat.md).

## Дослідіть API

| Посібник | Операції | Що ви отримуєте | Одиниця білінгу |
|---|---|---|---|
| [Вебпошук](https://openapi.felo.ai/uk/docs/data-api/guides/felo-web-search.md) | Пошук у вебі | Заголовки сторінок, посилання та фрагменти | Запит |
| [Читання вебсторінки](https://openapi.felo.ai/uk/docs/data-api/guides/felo-web-read.md) | Читання URL | Markdown, текст, HTML або знімок екрана | Запит |
| [Дані X](https://openapi.felo.ai/uk/docs/data-api/guides/felo-x-data.md) | Профілі, пошук користувачів, дописи користувачів, пошук дописів, відповіді | Структуровані користувачі та дописи з пагінацією там, де це підтримується | Повернутий результат |
| [Чат із прив’язкою до пошуку](https://openapi.felo.ai/uk/docs/data-api/guides/felo-chat.md) | Відповідь на запитання | Відповідь і вебджерела | Запит |
| [PPT](https://openapi.felo.ai/uk/docs/data-api/guides/felo-ppt.md) | Створення, статус, результати, експорт, статус експорту, видалення | Завдання генерації та PPTX, що можна завантажити | Згенерована сторінка; експорт оплачується окремо |
| [Білінг і помилки](https://openapi.felo.ai/uk/docs/data-api/guides/felo-billing.md) | Спільні вказівки щодо інтеграції | Ціни, робота з балансом і правила повторів | — |

У цих посібниках є **14 основних операцій**. Якщо створення PPT повертає `stream_key`, [посібник із PPT](https://openapi.felo.ai/uk/docs/data-api/guides/felo-ppt.md#sse) також пояснює, як читати події генерації через SSE. Запити статусу й результатів, запити статусу експорту та видалення не створюють нового списання.

## Перед перенесенням існуючої інтеграції

Використовуйте посібник для точного кінцевого пункту, який ви викликаєте. Заміна `/v2` на `/api/v1/data` — це не повна міграція:

- Web Read використовує `/web/read` з одним форматом виводу на запит.
- Chat повертає `status: "ok"`; він підтримує лише нестрімінговий JSON.
- Результати PPT використовують **POST** `/tasks/{task_id}/historical`.
- Створення PPT повертає ідентифікатори в корені JSON. Збережіть і `task_id`, і `ppt_business_id`.
- Згенеровані PPT закінчують термін дії через сім днів. Експортуйте та збережіть файл до закінчення цього терміну.

Тут не документовано нативний OpenAPI-аналог для кожного робочого процесу `/v2`, наприклад LiveDoc CRUD, Mindmap або SuperAgent. Продовжуйте використовувати їхні [посібники Felo APIs](https://openapi.felo.ai/uk/docs/api-reference/felo-apis.md) і білінг за Pro-кредитами.

## Контракт і поточні ціни

- [Опублікована схема OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json) — визначення полів і схеми відповідей.
- [Схема OpenAPI у YAML](https://openapi.felo.ai/api/v1/data/openapi.yaml) — для інструментів, що приймають YAML.
- [Поточні ціни](https://openapi.felo.ai/api/v1/data/prices) — ID операцій, одиниці білінгу та поточні тарифи.

Ці ресурси є публічними й доступні для читання без ключа. Дивіться [Білінг і помилки](https://openapi.felo.ai/uk/docs/data-api/guides/felo-billing.md) перед додаванням автоматичних повторів.