Початок роботи

Felo API Platform дає вам один ключ для інструментів агентів, протоколів моделей, а також API Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page і SuperAgent. Почніть тут, виберіть інструмент, який ви використовуєте, а потім перейдіть до його окремого посібника з налаштування.

Уперше тут? Прочитайте Огляд платформи, щоб дізнатися, як поєднуються Model API, Data API і Felo APIs, або одразу перейдіть до Протоколи та SDK і Канали та маршрутизація постачальників.

Налаштування Codex або Claude Code за допомогою CLI

Якщо у вас установлено Node.js 22+ і ваш інструмент ШІ, виконайте:

npx feloapi-cli setup

Дотримуйтеся підказок, щоб вставити повний API-ключ Felo і вибрати моделі, Skills або і те, і інше. Потім запустіть свій інструмент за допомогою npx feloapi-cli run codex або npx feloapi-cli run claude-code.

Встановлення та використання CLI

Схема швидкого старту

1. Отримайте ключ Felo API Platform і за потреби придбайте кредити послуг; підписка не потрібна.
2. Виберіть свій інструмент ШІ або платформу з таблиці нижче.
3. Відкрийте відповідний посібник із налаштування та вставте базову URL-адресу Felo й API-ключ.
4. Виконайте невелике завдання в цьому інструменті, щоб підтвердити з'єднання.
5. Додайте API робочих процесів, коли вашому агенту потрібні пошук, офісний вивід, вебвитяг, робочі процеси із зображеннями, LiveDocs або SuperAgent.

Крок 1: Отримайте API-ключ

Felo API Platform використовує один API-ключ для прямих викликів API і підтримуваних інструментів ШІ.

1. Відкрийте сторінку API-ключів Felo API Platform.
2. Увійдіть у свій обліковий запис Felo, якщо з'явиться запит.
3. Введіть назву ключа та натисніть Create Key.
4. Скопіюйте повний ключ, коли він з'явиться. Він показується лише один раз.
5. Зберігайте ключ у безпечному місці та використовуйте його як FELO_API_KEY.

Поповнюйте баланс у міру використання в Console Billing від 1 $. Ви купуєте кредити послуг у доларах США для фактичного використання API. Підписка не потрібна.

Установіть ключ як змінну середовища:

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell:

$env:FELO_API_KEY="YOUR_API_KEY"

Крок 2: Виберіть інструмент ШІ

Натисніть інструмент, який хочете використовувати. Кожне посилання відкриває окремий посібник із налаштування з правильною базовою URL-адресою, змінними середовища та кроком перевірки.

Крок 3: Використовуйте правильну базову URL-адресу

Більшість інструментів запитують три значення: API-ключ, базову URL-адресу та назву моделі. Виберіть базову URL-адресу залежно від протоколу, який підтримує інструмент.

Якщо ви не впевнені, який режим підтримує ваш клієнт, почніть із базової URL-адреси, сумісної з OpenAI. Використовуйте базову URL-адресу, сумісну з Anthropic, для Claude Code або клієнтів, які явно вимагають endpoint Anthropic Messages.

Крок 4: Перевірте прямим викликом API

Якщо ви хочете лише переконатися, що ваш ключ працює, викличте Chat API напряму.

curl -X POST https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Research the latest AI agent product trends"
  }'

Успішна відповідь містить відповідь, аналіз запиту та вебресурси.

{
  "status": "ok",
  "data": {
    "id": "HabCj883yHLSXc8mWqu4Eq",
    "message_id": "18ea8517-5559-4f48-a355-1f8a79e73b71",
    "answer": "...",
    "query_analysis": {
      "queries": ["AI agent product trends"]
    },
    "resources": [
      {
        "link": "https://example.com/report",
        "title": "AI Agent Market Report",
        "snippet": "..."
      }
    ]
  }
}

Крок 5: Додайте API робочих процесів

Після того як ваш перший інструмент або виклик API запрацює, підключіть API, що відповідають вашому сценарію.

Приклади прямих викликів API

Якщо ви працюєте безпосередньо з API, а не налаштовуєте інструмент ШІ, почніть з одного з цих мінімальних викликів.

Створення завдання PPT

Використовуйте PPT Task API, коли хочете асинхронно згенерувати презентацію. Відповідь повертає task_id, який можна опитувати.

curl -X POST https://openapi.felo.ai/v2/ppts \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Create a 5-slide strategy deck about AI agents for office productivity"
  }'

Приклад відповіді:

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
    "livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
    "ppt_business_id": "BfLPuQKmChk9SPmyQawxgr"
  }
}

Опитуйте стан завдання:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

Створення завдання Landing Page

Використовуйте Landing Page Task API, коли хочете, щоб Felo згенерував цільову сторінку з підказки.

curl -X POST https://openapi.felo.ai/v2/landing_page \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Generate a launch landing page for an AI research assistant"
  }'

Приклад відповіді:

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
    "thread_short_id": "9qiLTmT77fA3aVurrMHvRJ"
  }
}

Опитуйте той самий endpoint стану завдання, який використовують завдання PPT:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

Python

import os
import requests

api_key = os.environ["FELO_API_KEY"]

response = requests.post(
    "https://openapi.felo.ai/v2/chat",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={"query": "What are the latest AI agent product trends?"},
    timeout=60,
)

response.raise_for_status()
print(response.json()["data"]["answer"])

JavaScript (Node.js)

const response = await fetch("https://openapi.felo.ai/v2/chat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FELO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "What are the latest AI agent product trends?",
  }),
});

if (!response.ok) {
  throw new Error(`Felo API request failed: ${response.status}`);
}

const result = await response.json();
console.log(result.data.answer);

Типові проблеми налаштування

Наступні кроки

• Налаштувати Codex
• Налаштувати Claude Code
• Посібник з автентифікації
• Довідник LLM API
• Довідник Chat API
• Довідник SuperAgent API