# Настройка Felo API

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

Felo — это один из поставщиков в [Data API](https://openapi.felo.ai/ru/docs/data-api), предлагающий веб-поиск, чтение веб-страниц, данные X, ответы с опорой на поиск и презентации. Найдите каждую конечную точку Felo рядом с другими поставщиками в соответствующей категории Data API.

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

Чтобы использовать кредиты Felo Pro, см. [существующие Felo APIs](https://openapi.felo.ai/ru/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/ru/docs/data-api/guides/felo-chat.md).

## Изучите API

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

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

## Перед переносом существующей интеграции

Используйте руководство для точной конечной точки, которую вы вызываете. Замена `/v2` на `/api/v1/data` — это не полный перенос:

- Чтение веб-страниц использует `/web/read`, по одному выходному формату на запрос.
- Чат возвращает `status: "ok"`; поддерживается только JSON без потоковой передачи.
- Результаты PPT используют **POST** `/tasks/{task_id}/historical`.
- Создание PPT возвращает идентификаторы в корне JSON. Сохраните и `task_id`, и `ppt_business_id`.
- Сгенерированные PPT истекают через семь дней. Экспортируйте и сохраните файл до истечения срока.

Здесь не задокументирован нативный OpenAPI-эквивалент для каждого рабочего процесса `/v2`, такого как CRUD LiveDoc, Mindmap или SuperAgent. Продолжайте использовать их [руководства Felo APIs](https://openapi.felo.ai/ru/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) — идентификаторы операций, единицы биллинга и текущие тарифы.

Эти ресурсы общедоступны и могут быть прочитаны без ключа. См. [Биллинг и ошибки](https://openapi.felo.ai/ru/docs/data-api/guides/felo-billing.md) перед добавлением автоматических повторов.