# Обзор Felo API

Felo workflows under /v2, called with Felo Pro credits. Compare them with platform-balance APIs.

Чтобы оплачивать веб-поиск, чтение веб-страниц, данные X, Chat или PPT с помощью **баланса платформы**, используйте [Felo в Data API](https://openapi.felo.ai/ru/docs/api-reference/openapi/overview.md). На этой странице документированы существующие `/v2` APIs, которые используют **Felo Pro credits**.

Felo APIs — это first-party API уровня рабочих процессов для поиска, документов, презентаций, извлечения веб-данных, социального поиска и рабочих процессов агентов. Они используют тот же Felo API key, что и остальная платформа, но тарифицируются отдельно от вызовов моделей.

::: tip Felo Pro subscription credits
**Felo APIs в настоящее время принимают подписочные кредиты Felo Pro.** Это относится к first-party `/v2` APIs в этом разделе: Felo Search, PPT Task, Mindmap, LiveDoc, Web Fetch, X Search, YouTube Subtitling, Landing Page и SuperAgent.

Это **не** относится к вызовам Model API (`/api/v1`). Для вызовов моделей требуются предоплаченные сервисные кредиты Felo API Platform; кредиты подписки Felo Pro для них не используются.
:::

Право на использование может измениться. Страница [Console Billing](https://openapi.felo.ai/console/billing) — это источник истины для вашего текущего баланса и использования.

## API в этом разделе

| API | Конечная точка | Для чего использовать |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/ru/docs/api-reference/chat.md) | `POST /v2/chat` | Разговорный веб-поиск с анализом запроса, источниками и цитатами |
| [PPT Task API](https://openapi.felo.ai/ru/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | Генерировать слайд-дэки и опрашивать статус задачи |
| [Mindmap API](https://openapi.felo.ai/ru/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | Преобразовать запрос или контекст LiveDoc в mindmap |
| [LiveDoc API](https://openapi.felo.ai/ru/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | Создавать базы знаний, управлять ресурсами и извлекать контекст |
| [Web Fetch API](https://openapi.felo.ai/ru/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | Извлекать веб-страницу как HTML, текст или Markdown |
| [X Search API](https://openapi.felo.ai/ru/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | Искать пользователей X, твиты, ленты и ответы |
| [YouTube Subtitling API](https://openapi.felo.ai/ru/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | Получать субтитры и временные метки YouTube |
| [Landing Page Task API](https://openapi.felo.ai/ru/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | Асинхронно генерировать лендинг |
| [SuperAgent API](https://openapi.felo.ai/ru/docs/api-reference/superagent.md) | `POST /v2/conversations` | Выполнять разговор агента через SSE |

## Аутентификация и первый вызов

Создайте один Felo API key в [Console → API Keys](https://openapi.felo.ai/console/api-keys) и отправляйте его как Bearer token.

```bash
export FELO_API_KEY="YOUR_API_KEY"

curl -sS https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What are the latest AI agent trends?"}'
```

Успешный ответ включает ответ, анализ запроса и цитируемые веб-ресурсы.

## Модель биллинга

| Интерфейс | Путь | Как оплачиваются вызовы |
|---|---|---|
| Felo APIs | `/v2/*` | Felo Pro credits |
| [Felo в Data API](https://openapi.felo.ai/ru/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | Баланс платформы, а не Pro credits |
| Model API | `/api/v1/*` | Только предоплаченные сервисные кредиты Felo API Platform; Felo Pro не применяется |
| Data API | `/v1/beta/*` | Использует базу биллинга каталога API, указанную для каждой конечной точки |

Felo Pro credits и сервисные кредиты API — это разные балансы. Подписка Felo Pro не дает автоматически сервисные кредиты API, и сервисные кредиты API не добавляют кредиты подписки Felo Pro.

## Связанное

- [Felo Search API](https://openapi.felo.ai/ru/docs/api-reference/chat.md)
- [Биллинг и кредиты](https://openapi.felo.ai/ru/docs/faq/billing-and-credits.md)
- [Ошибки, лимиты и повторы](https://openapi.felo.ai/ru/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)