Налаштування 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 використовує
/web/readз одним форматом виводу на запит. - Chat повертає
status: "ok"; він підтримує лише нестрімінговий JSON. - Результати PPT використовують POST
/tasks/{task_id}/historical. - Створення PPT повертає ідентифікатори в корені JSON. Збережіть і
task_id, іppt_business_id. - Згенеровані PPT закінчують термін дії через сім днів. Експортуйте та збережіть файл до закінчення цього терміну.
Тут не документовано нативний OpenAPI-аналог для кожного робочого процесу /v2, наприклад LiveDoc CRUD, Mindmap або SuperAgent. Продовжуйте використовувати їхні посібники Felo APIs і білінг за Pro-кредитами.
Контракт і поточні ціни
- Опублікована схема OpenAPI — визначення полів і схеми відповідей.
- Схема OpenAPI у YAML — для інструментів, що приймають YAML.
- Поточні ціни — ID операцій, одиниці білінгу та поточні тарифи.
Ці ресурси є публічними й доступні для читання без ключа. Дивіться Білінг і помилки перед додаванням автоматичних повторів.