Руководства
Обзор платформы
Разберитесь, как устроены Model API, Data API и Felo APIs и с чего начать.
Felo API Platform даёт один API key для трёх разных поверхностей запросов. У них общий аккаунт, кредиты и ключ, но они решают разные задачи и используют разные base URL.
Три поверхности
| Поверхность | Base URL | Для чего | Справочник |
|---|---|---|---|
| Model API | https://openapi.felo.ai/api/v1 (OpenAI-compatible) и https://openapi.felo.ai/api (Anthropic-compatible) | Прямой вызов языковой, графической, видео- или decision-модели | Model API |
| Data API | https://openapi.felo.ai/v1/beta | Вызов именованных сторонних поставщиков данных и поиска | Data API |
| Felo APIs | https://openapi.felo.ai/v2 | Собственные рабочие сценарии Felo: поиск, офис, контент, извлечение данных, базы знаний | Felo API reference |
Какую поверхность использовать?
| Мне нужно… | Используйте |
|---|---|
| Запускать LLM из своего кода или AI-инструмента для разработки | Model API |
| Получить ответ с веб-поиском, citations и анализом query | Chat API (/v2/chat) |
| Сгенерировать презентацию, landing page, mindmap или видео | Соответствующий Felo task или model endpoint |
| Создать базу знаний и выполнять по ней поиск | LiveDoc API |
| Вызывать Tavily, Exa, Apollo или другого именованного поставщика данных | Data API |
| Закрепить модель за конкретным upstream-провайдером | Model API с X-Felo-Channel |
Общая настройка
- Создайте один API key в консоли Felo API Platform.
- Передавайте его как
Authorization: Bearer $FELO_API_KEY. - Пополняйте сервисные кредиты в долларах США по мере использования.
- Выберите base URL для нужной поверхности.
Один и тот же key работает во всех описанных здесь поверхностях. Для разных окружений используйте разные ключи, чтобы ротация одного не затрагивала другое.
Что даёт платформа
- Один key вместо отдельного аккаунта у каждого поставщика моделей и данных.
- Публичный каталог моделей с ID, лимитами context, протоколами и тарифами.
- Опубликованные цены поставщиков для моделей, доступных через несколько каналов.
- Единый учёт использования и оплаты в консоли.
Дальше
- Модели и цены — прочитать каталог и оценить стоимость запроса.
- Каналы и маршрутизация провайдеров — закрепить модель за провайдером.
- Протоколы и SDK — выбрать между OpenAI-compatible, Responses и Messages.
- Асинхронные задачи — работа с PPT, landing page, видео и экспортом.
- Обзор Data API — вызов сторонних endpoint через общий префикс.