Pierwsze kroki

Felo API Platform daje Ci jeden klucz do narzędzi agentowych, protokołów modeli oraz interfejsów API Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page i SuperAgent. Zacznij tutaj, wybierz narzędzie, którego używasz, a następnie postępuj według poświęconego mu przewodnika konfiguracji.

Jesteś tu pierwszy raz? Przeczytaj Przegląd platformy, aby dowiedzieć się, jak łączą się Model API, Data API i Felo APIs, albo przejdź od razu do Protokoły i SDK oraz Kanały i routing dostawców.

Konfiguracja Codex lub Claude Code za pomocą CLI

Mając Node.js 22+ i zainstalowane narzędzie AI, uruchom:

npx feloapi-cli setup

Postępuj zgodnie z monitami, aby wkleić pełny klucz API Felo i wybrać modele, Skills lub jedno i drugie. Następnie uruchom narzędzie poleceniem npx feloapi-cli run codex lub npx feloapi-cli run claude-code.

Instalacja i użycie CLI

Szybki przepływ startowy

1. Pobierz klucz Felo API Platform i w razie potrzeby dokup kredyty usługowe; subskrypcja nie jest wymagana.
2. Wybierz narzędzie AI lub platformę z tabeli poniżej.
3. Otwórz pasujący przewodnik konfiguracji i wklej bazowy adres URL Felo oraz klucz API.
4. Uruchom małe zadanie w tym narzędziu, aby potwierdzić połączenie.
5. Dodaj interfejsy API przepływów pracy, gdy Twój agent potrzebuje wyszukiwania, wyników biurowych, ekstrakcji z sieci, przepływów obrazów, LiveDoców lub SuperAgent.

Krok 1: Pobierz klucz API

Felo API Platform używa jednego klucza API zarówno w bezpośrednich wywołaniach API, jak i w obsługiwanych narzędziach AI.

1. Otwórz stronę kluczy API Felo API Platform.
2. Zaloguj się swoim kontem Felo, jeśli zostaniesz o to poproszony.
3. Wprowadź nazwę klucza i kliknij Create Key.
4. Skopiuj pełny klucz, gdy się pojawi. Jest wyświetlany tylko raz.
5. Przechowuj klucz bezpiecznie i używaj go jako FELO_API_KEY.

Doładowuj konto w miarę potrzeb w Console Billing od 1 USD. Kupujesz kredyty usługowe denominowane w USD za rzeczywiste zużycie API. Subskrypcja nie jest wymagana.

Ustaw klucz jako zmienną środowiskową:

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell:

$env:FELO_API_KEY="YOUR_API_KEY"

Krok 2: Wybierz narzędzie AI

Kliknij narzędzie, którego chcesz używać. Każdy link otwiera poświęcony przewodnik konfiguracji z właściwym bazowym adresem URL, zmiennymi środowiskowymi i krokiem weryfikacji.

Krok 3: Użyj właściwego bazowego adresu URL

Większość narzędzi prosi o trzy wartości: klucz API, bazowy adres URL i nazwę modelu. Wybierz bazowy adres URL na podstawie protokołu obsługiwanego przez narzędzie.

Jeśli nie jesteś pewien, który tryb obsługuje Twój klient, zacznij od bazowego adresu URL zgodnego z OpenAI. Bazowego adresu URL zgodnego z Anthropic używaj dla Claude Code lub klientów, które wyraźnie proszą o endpoint Anthropic Messages.

Krok 4: Weryfikacja bezpośrednim wywołaniem API

Jeśli chcesz tylko potwierdzić, że klucz działa, wywołaj API Chat bezpośrednio.

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"
  }'

Skuteczna odpowiedź zawiera odpowiedź, analizę zapytania i zasoby sieciowe.

{
  "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": "..."
      }
    ]
  }
}

Krok 5: Dodaj interfejsy API przepływów pracy

Gdy pierwsze narzędzie lub wywołanie API zadziała, podłącz interfejsy API pasujące do Twojego scenariusza.

Bezpośrednie przykłady API

Jeśli budujesz bezpośrednio na API zamiast konfigurować narzędzie AI, zacznij od jednego z tych minimalnych wywołań.

Tworzenie zadania PPT

Użyj API zadań PPT, gdy chcesz asynchronicznie wygenerować zestaw slajdów. Odpowiedź zwraca task_id, który możesz odpytywać.

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"
  }'

Przykładowa odpowiedź:

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

Odpytuj stan zadania:

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

Tworzenie zadania strony docelowej

Użyj API zadań Landing Page, gdy chcesz, aby Felo wygenerował stronę docelową na podstawie promptu.

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"
  }'

Przykładowa odpowiedź:

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

Odpytuj ten sam endpoint stanu zadania, którego używają zadania 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);

Typowe problemy z konfiguracją

Następne kroki

• Konfiguracja Codex
• Konfiguracja Claude Code
• Przewodnik uwierzytelniania
• Dokumentacja API LLM
• Dokumentacja API Chat
• Dokumentacja API SuperAgent