Felo API PlatformFelo API Platform

Začínáme

Začínáme

Vytvořte klíč API, vyberte nástroj AI, otevřete jeho průvodce nastavením a spusťte první volání API ve svém postupu.

Felo API Platform vám dává jeden klíč pro agentní nástroje, modelové protokoly, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page a SuperAgent API. Začněte zde, vyberte nástroj, který používáte, a potom postupujte podle jeho specializované příručky k nastavení.

Jste tu poprvé? Přečtěte si Přehled platformy, kde se dozvíte, jak do sebe zapadají Model API, Data API a Felo API, nebo přejděte přímo na Protokoly a SDK a Kanály a směrování poskytovatelů.

Konfigurace Codexu nebo Claude Code pomocí CLI

S Node.js 22+ a nainstalovaným AI nástrojem spusťte:

npx feloapi-cli setup

Postupujte podle výzev, vložte svůj kompletní Felo API klíč a zvolte modely, Skills nebo obojí. Potom nástroj spusťte pomocí npx feloapi-cli run codex nebo npx feloapi-cli run claude-code.

Instalace a použití CLI

Postup rychlého startu

  1. Získejte klíč Felo API Platform a v případě potřeby zakupte kredity služeb; předplatné není nutné.
  2. Vyberte svůj AI nástroj nebo platformu z tabulky níže.
  3. Otevřete odpovídající příručku k nastavení a vložte základní URL Felo a API klíč.
  4. Spusťte v daném nástroji malou úlohu a ověřte připojení.
  5. Přidejte workflow API, když váš agent potřebuje vyhledávání, kancelářský výstup, extrakci z webu, práci s obrázky, LiveDocy nebo SuperAgent.

Krok 1: Získejte API klíč

Felo API Platform používá jeden API klíč pro přímá volání API i pro podporované AI nástroje.

  1. Otevřete stránku API klíčů Felo API Platform.
  2. Pokud budete vyzváni, přihlaste se svým účtem Felo.
  3. Zadejte název klíče a klikněte na Create Key.
  4. Zkopírujte celý klíč, jakmile se zobrazí. Zobrazí se pouze jednou.
  5. Klíč bezpečně uložte a používejte jej jako FELO_API_KEY.

Dobíjejte průběžně v Console Billing od $1. Nakupujete kredity služeb v amerických dolarech pro skutečné využití API. Předplatné není nutné.

Nastavte klíč jako proměnnou prostředí:

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell:

$env:FELO_API_KEY="YOUR_API_KEY"

Krok 2: Vyberte si AI nástroj

Klikněte na nástroj, který chcete používat. Každý odkaz otevře specializovanou příručku k nastavení se správnou základní URL, proměnnými prostředí a krokem ověření.

NástrojNejvhodnější proPříručka k nastavení
CodexPracovní postupy programování v CLI, revize kódu, změny v repozitáři a automatizaceNastavení Codexu
Claude CodeAgentní programování, úpravy repozitáře, vývoj s podporou výzkumu a práce s dlouhým kontextemNastavení Claude Code
OpenCodeProgramovací relace v terminálu a směrování poskytovatelů kompatibilních s OpenAINastavení OpenCode
OpenClawPracovní postupy osobního AI asistenta a lokální agentiNastavení OpenClaw
Hermes AgentExperimenty s agenty a orchestraci více nástrojůNastavení Hermes Agent
TRAEPracovní postupy v AI IDE a editace s asistencíNastavení TRAE
OpenVikingExperimenty s agenty a přepínání poskytovatelůNastavení OpenViking
CursorAI programování v editoruNastavení Cursor
ClinePracovní postupy agenta ve VS Code a programování s asistencí termináluNastavení Cline
Roo CodeProgramovací agenti ve VS Code a plánování úlohNastavení Roo Code
Kilo CodeLokální programovací agenti a testování poskytovatelů modelůNastavení Kilo Code
Další AI nástrojeJakýkoli klient, který přijímá vlastní API klíč, základní URL a název modeluNastavení dalších nástrojů

Krok 3: Použijte správnou základní URL

Většina nástrojů vyžaduje tři hodnoty: API klíč, základní URL a název modelu. Základní URL vyberte podle protokolu, který nástroj podporuje.

Nástroj vyžadujePoužijte tuto hodnotu
API klíčVáš FELO_API_KEY
Základní URL kompatibilní s OpenAIhttps://openapi.felo.ai/api/v1
Základní URL kompatibilní s Anthropichttps://openapi.felo.ai/api
ID modeluZvolte aktuálně dostupné ID z katalogu modelů

Pokud si nejste jisti, který režim váš klient podporuje, začněte se základní URL kompatibilní s OpenAI. Základní URL kompatibilní s Anthropic použijte pro Claude Code nebo klienty, kteří výslovně vyžadují endpoint Anthropic Messages.

Krok 4: Ověřte přímým voláním API

Pokud chcete pouze ověřit, že váš klíč funguje, zavolejte přímo 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"
  }'

Úspěšná odpověď obsahuje odpověď, analýzu dotazu a webové zdroje.

{
  "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: Přidejte workflow API

Poté, co váš první nástroj nebo volání API funguje, připojte API, která odpovídají vašemu scénáři.

ScénářDoporučená APIDokumentace
Agent pro vyhledávání a výzkumChat, Web Fetch, X Search, YouTube Subtitling, LiveDocsChat API
Agent pro kancelářskou produktivituPPT Task, Mindmap, LiveDocs, SuperAgentPPT Task API
Agent pro kreativní operaceLanding Page, práce s obrázky, Web Fetch, Search, SuperAgentLanding Page API
Full-stack AI aplikaceLLM API, Chat, LiveDocs, Web Fetch, SuperAgentLLM API
Znalostní workflowLiveDocs, Web Fetch, Chat, SuperAgentLiveDoc API

Příklady přímého volání API

Pokud pracujete přímo s API namísto konfigurace AI nástroje, začněte jedním z těchto minimálních volání.

Vytvoření úlohy PPT

PPT Task API použijte, když chcete asynchronně vygenerovat prezentaci. Odpověď vrací task_id, na který můžete dotazovat.

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

Příklad odpovědi:

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

Dotazujte se na stav úlohy:

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

Vytvoření úlohy Landing Page

Landing Page Task API použijte, když chcete, aby Felo vygenerovalo landing page z 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"
  }'

Příklad odpovědi:

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

Dotazujte se na stejný endpoint stavu úlohy, který používají úlohy 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);

Běžné problémy s nastavením

ProblémCo zkontrolovat
UNAUTHORIZEDOvěřte, že je klíč zkopírován správně, není zrušený a odesílá se jako Authorization: Bearer $FELO_API_KEY
Nástroj volá nesprávného poskytovateleZkontrolujte, že je v aktuálním pracovním prostoru nebo relaci vybrán poskytovatel Felo
Klient kompatibilní s OpenAI selháváPoužijte https://openapi.felo.ai/api/v1 jako základní URL
Klient kompatibilní s Anthropic selháváPoužijte https://openapi.felo.ai/api jako základní URL
Asynchronní úloha zatím nemá výsledekDotazujte se na endpoint stavu úlohy, dokud se úloha nedokončí

Další kroky