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 setupPostupujte 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.
Postup rychlého startu
- Získejte klíč Felo API Platform a v případě potřeby zakupte kredity služeb; předplatné není nutné.
- Vyberte svůj AI nástroj nebo platformu z tabulky níže.
- Otevřete odpovídající příručku k nastavení a vložte základní URL Felo a API klíč.
- Spusťte v daném nástroji malou úlohu a ověřte připojení.
- 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.
- Otevřete stránku API klíčů Felo API Platform.
- Pokud budete vyzváni, přihlaste se svým účtem Felo.
- Zadejte název klíče a klikněte na Create Key.
- Zkopírujte celý klíč, jakmile se zobrazí. Zobrazí se pouze jednou.
- 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ástroj | Nejvhodnější pro | Příručka k nastavení |
|---|---|---|
| Codex | Pracovní postupy programování v CLI, revize kódu, změny v repozitáři a automatizace | Nastavení Codexu |
| Claude Code | Agentní programování, úpravy repozitáře, vývoj s podporou výzkumu a práce s dlouhým kontextem | Nastavení Claude Code |
| OpenCode | Programovací relace v terminálu a směrování poskytovatelů kompatibilních s OpenAI | Nastavení OpenCode |
| OpenClaw | Pracovní postupy osobního AI asistenta a lokální agenti | Nastavení OpenClaw |
| Hermes Agent | Experimenty s agenty a orchestraci více nástrojů | Nastavení Hermes Agent |
| TRAE | Pracovní postupy v AI IDE a editace s asistencí | Nastavení TRAE |
| OpenViking | Experimenty s agenty a přepínání poskytovatelů | Nastavení OpenViking |
| Cursor | AI programování v editoru | Nastavení Cursor |
| Cline | Pracovní postupy agenta ve VS Code a programování s asistencí terminálu | Nastavení Cline |
| Roo Code | Programovací agenti ve VS Code a plánování úloh | Nastavení Roo Code |
| Kilo Code | Lokální programovací agenti a testování poskytovatelů modelů | Nastavení Kilo Code |
| Další AI nástroje | Jakýkoli klient, který přijímá vlastní API klíč, základní URL a název modelu | Nastavení 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žaduje | Použijte tuto hodnotu |
|---|---|
| API klíč | Váš FELO_API_KEY |
| Základní URL kompatibilní s OpenAI | https://openapi.felo.ai/api/v1 |
| Základní URL kompatibilní s Anthropic | https://openapi.felo.ai/api |
| ID modelu | Zvolte 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á API | Dokumentace |
|---|---|---|
| Agent pro vyhledávání a výzkum | Chat, Web Fetch, X Search, YouTube Subtitling, LiveDocs | Chat API |
| Agent pro kancelářskou produktivitu | PPT Task, Mindmap, LiveDocs, SuperAgent | PPT Task API |
| Agent pro kreativní operace | Landing Page, práce s obrázky, Web Fetch, Search, SuperAgent | Landing Page API |
| Full-stack AI aplikace | LLM API, Chat, LiveDocs, Web Fetch, SuperAgent | LLM API |
| Znalostní workflow | LiveDocs, Web Fetch, Chat, SuperAgent | LiveDoc 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ém | Co zkontrolovat |
|---|---|
UNAUTHORIZED | Ověř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 poskytovatele | Zkontrolujte, ž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ýsledek | Dotazujte se na endpoint stavu úlohy, dokud se úloha nedokončí |