Настройка Felo API
Поставщик: Felo · Оплачивается балансом платформы
Felo — это один из поставщиков в Data API, предлагающий веб-поиск, чтение веб-страниц, данные X, ответы с опорой на поиск и презентации. Найдите каждую конечную точку Felo рядом с другими поставщиками в соответствующей категории Data API.
Эти конечные точки используют баланс платформы и префикс /api/v1/data. В этом руководстве объясняются аутентификация, ваш первый запрос и где найти правила биллинга.
Чтобы использовать кредиты Felo Pro, см. существующие Felo APIs. Баланс платформы и кредиты Pro — это разные сущности.
Выполните свой первый запрос
- Создайте ключ в Console → API Keys.
- Проверьте или пополните свой баланс платформы в Console → Billing.
- Установите ключ на сервере или в локальной оболочке:
export FELO_API_KEY="YOUR_API_KEY"Отправляйте Authorization: Bearer $FELO_API_KEY. Также принимается X-API-Key; выберите один способ аутентификации. Для JSON-запросов нужен Content-Type: application/json.
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.
Изучите API
| Руководство | Операции | Что вы получаете | Единица биллинга |
|---|---|---|---|
| Веб-поиск | Поиск в вебе | Заголовки страниц, ссылки и фрагменты | Запрос |
| Чтение веб-страниц | Чтение URL | Markdown, текст, HTML или снимок экрана | Запрос |
| Данные X | Профили, поиск пользователей, посты пользователей, поиск постов, ответы | Структурированные пользователи и посты, с пагинацией там, где она поддерживается | Возвращенный результат |
| Чат с опорой на поиск | Ответ на вопрос | Ответ и веб-источники | Запрос |
| PPT | Создание, статус, результаты, экспорт, статус экспорта, удаление | Задача генерации и загружаемый PPTX | Сгенерированная страница; экспорт тарифицируется отдельно |
| Биллинг и ошибки | Общее руководство по интеграции | Цены, обработка баланса и правила повторов | — |
В этих руководствах в общей сложности 14 основных операций. Если создание PPT возвращает stream_key, руководство PPT также объясняет, как читать события генерации через 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 и биллинг по Pro-кредитам.
Контракт и текущие цены
- Опубликованная схема OpenAPI — определения полей и схемы ответов.
- Схема OpenAPI YAML — для инструментов, принимающих YAML.
- Текущие цены — идентификаторы операций, единицы биллинга и текущие тарифы.
Эти ресурсы общедоступны и могут быть прочитаны без ключа. См. Биллинг и ошибки перед добавлением автоматических повторов.