# Огляд Felo APIs

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/uk/docs/api-reference/openapi/overview.md). Ця сторінка документує наявні `/v2` APIs, які використовують **Felo Pro credits**.

Felo APIs — це першосторонні API рівня робочих процесів для пошуку, документів, презентацій, вилучення вебданих, соціального пошуку та агентних workflow. Вони використовують той самий Felo API key, що й решта платформи, але оплачуються окремо від викликів моделей.

::: tip Felo Pro subscription credits
**Felo APIs наразі приймають Felo Pro subscription credits.** Це стосується першосторонніх `/v2` APIs у цьому розділі: Felo Search, PPT Task, Mindmap, LiveDoc, Web Fetch, X Search, YouTube Subtitling, Landing Page та SuperAgent.

Це **не** стосується викликів Model API (`/api/v1`). Виклики моделей потребують передплачених service credits Felo API Platform; Felo Pro subscription credits для них не можна використовувати.
:::

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

## API в цьому розділі

| API | Кінцева точка | Для чого використовувати |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/uk/docs/api-reference/chat.md) | `POST /v2/chat` | Розмовний вебпошук із аналізом запиту, джерелами та цитатами |
| [PPT Task API](https://openapi.felo.ai/uk/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | Генерація колод слайдів і опитування статусу завдання |
| [Mindmap API](https://openapi.felo.ai/uk/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | Перетворення запиту або контексту LiveDoc у mindmap |
| [LiveDoc API](https://openapi.felo.ai/uk/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | Створення баз знань, керування ресурсами та retrieval контексту |
| [Web Fetch API](https://openapi.felo.ai/uk/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | Вилучення вебсторінки як HTML, тексту або Markdown |
| [X Search API](https://openapi.felo.ai/uk/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | Пошук користувачів X, дописів, стрічок і відповідей |
| [YouTube Subtitling API](https://openapi.felo.ai/uk/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | Отримання субтитрів YouTube і часових міток |
| [Landing Page Task API](https://openapi.felo.ai/uk/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | Асинхронна генерація landing page |
| [SuperAgent API](https://openapi.felo.ai/uk/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 in Data API](https://openapi.felo.ai/uk/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | Баланс платформи, а не Pro credits |
| Model API | `/api/v1/*` | Лише передплачені service credits Felo API Platform; Felo Pro не застосовується |
| Data API | `/v1/beta/*` | Використовує основу білінгу з каталогу API, показану для кожної кінцевої точки |

Felo Pro credits і API service credits — це окремі баланси. Підписка Felo Pro не надає автоматично API service credits, а API service credits не додають Felo Pro subscription credits.

## Пов’язане

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