Erste Schritte
Erste Schritte
Holen Sie sich einen API-Schlüssel, wählen Sie ein KI-Tool, öffnen Sie dessen Einrichtungsanleitung und führen Sie Ihren ersten Workflow-API-Aufruf aus.
Die Felo API Platform gibt Ihnen einen Schlüssel für Agent-Tools, Modellprotokolle sowie die APIs für Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page und SuperAgent. Beginnen Sie hier, wählen Sie das Tool, das Sie verwenden, und folgen Sie dann der eigenen Einrichtungsanleitung für dieses Tool.
Neu hier? Lesen Sie die Plattformübersicht, um zu erfahren, wie Model API, Data API und Felo APIs zusammenwirken, oder gehen Sie direkt zu Protokolle und SDKs und Kanäle und Anbieter-Routing.
Codex oder Claude Code mit der CLI konfigurieren
Mit Node.js 22+ und Ihrem installierten KI-Tool führen Sie aus:
npx feloapi-cli setupFolgen Sie den Anweisungen, fügen Sie Ihren vollständigen Felo API-Schlüssel ein und wählen Sie Modelle, Skills oder beides. Starten Sie Ihr Tool anschließend mit npx feloapi-cli run codex oder npx feloapi-cli run claude-code.
Installation und Verwendung der CLI
Schnellstart-Ablauf
- Rufen Sie einen Schlüssel für die Felo API Platform ab und kaufen Sie bei Bedarf Service-Guthaben. Ein Abonnement ist nicht erforderlich.
- Wählen Sie Ihr KI-Tool oder Ihre Plattform aus der Tabelle unten.
- Öffnen Sie die passende Einrichtungsanleitung und fügen Sie die Felo Base-URL und den API-Schlüssel ein.
- Führen Sie eine kleine Aufgabe in diesem Tool aus, um die Verbindung zu bestätigen.
- Binden Sie Workflow-APIs ein, wenn Ihr Agent Suche, Office-Ausgabe, Web-Extraktion, Bild-Workflows, LiveDocs oder SuperAgent benötigt.
Schritt 1: API-Schlüssel abrufen
Die Felo API Platform verwendet einen API-Schlüssel für direkte API-Aufrufe und unterstützte KI-Tools.
- Öffnen Sie die Seite „API-Schlüssel“ der Felo API Platform.
- Melden Sie sich bei Aufforderung mit Ihrem Felo-Konto an.
- Geben Sie einen Schlüsselnamen ein und klicken Sie auf Create Key.
- Kopieren Sie den vollständigen Schlüssel, sobald er angezeigt wird. Er wird nur einmal angezeigt.
- Bewahren Sie den Schlüssel sicher auf und verwenden Sie ihn als
FELO_API_KEY.
Laden Sie bei Bedarf in Console Billing ab 1 $ auf. Sie kaufen auf USD lautende Service-Guthaben für die tatsächliche API-Nutzung. Ein Abonnement ist nicht erforderlich.
Legen Sie den Schlüssel als Umgebungsvariable fest:
export FELO_API_KEY="YOUR_API_KEY"Windows PowerShell:
$env:FELO_API_KEY="YOUR_API_KEY"Schritt 2: KI-Tool auswählen
Klicken Sie auf das Tool, das Sie verwenden möchten. Jeder Link öffnet eine eigene Einrichtungsanleitung mit der richtigen Base-URL, den Umgebungsvariablen und einem Prüfschritt.
| Tool | Am besten geeignet für | Einrichtungsanleitung |
|---|---|---|
| Codex | CLI-Coding-Workflows, Code-Review, Repository-Änderungen und Automatisierung | Codex einrichten |
| Claude Code | Agent-Coding, Repository-Bearbeitung, recherchegestützte Entwicklung und Arbeit mit langem Kontext | Claude Code einrichten |
| OpenCode | Coding-Sitzungen im Terminal und OpenAI-kompatibles Anbieter-Routing | OpenCode einrichten |
| OpenClaw | Workflows mit persönlichem KI-Assistenten und lokale Agenten | OpenClaw einrichten |
| Hermes Agent | Agent-Experimente und Orchestrierung mehrerer Tools | Hermes Agent einrichten |
| TRAE | KI-IDE-Workflows und unterstützte Bearbeitung | TRAE einrichten |
| OpenViking | Agent-Experimente und Anbieterwechsel | OpenViking einrichten |
| Cursor | KI-Coding in einem Editor | Cursor einrichten |
| Cline | Agent-Workflows in VS Code und terminalgestütztes Coding | Cline einrichten |
| Roo Code | Coding-Agenten in VS Code und Aufgabenplanung | Roo Code einrichten |
| Kilo Code | Lokale Coding-Agenten und Tests von Modellanbietern | Kilo Code einrichten |
| Andere KI-Tools | Jeder Client, der einen eigenen API-Schlüssel, eine Base-URL und einen Modellnamen akzeptiert | Andere Tools einrichten |
Schritt 3: Richtige Base-URL verwenden
Die meisten Tools fragen drei Werte ab: API-Schlüssel, Base-URL und Modellname. Wählen Sie die Base-URL nach dem Protokoll, das das Tool unterstützt.
| Das Tool fragt nach | Verwenden Sie diesen Wert |
|---|---|
| API-Schlüssel | Ihren FELO_API_KEY |
| OpenAI-kompatible Base-URL | https://openapi.felo.ai/api/v1 |
| Anthropic-kompatible Base-URL | https://openapi.felo.ai/api |
| Modell-ID | Eine derzeit verfügbare ID aus dem Modellkatalog |
Wenn Sie nicht sicher sind, welchen Modus Ihr Client unterstützt, beginnen Sie mit der OpenAI-kompatiblen Base-URL. Verwenden Sie die Anthropic-kompatible Base-URL für Claude Code oder für Clients, die ausdrücklich einen Anthropic-Messages-Endpoint verlangen.
Schritt 4: Mit einem direkten API-Aufruf prüfen
Wenn Sie nur bestätigen möchten, dass Ihr Schlüssel funktioniert, rufen Sie die Chat API direkt auf.
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"
}'Eine erfolgreiche Antwort enthält einen Antworttext, eine Abfrageanalyse und Web-Ressourcen.
{
"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": "..."
}
]
}
}Schritt 5: Workflow-APIs einbinden
Nachdem Ihr erstes Tool oder Ihr erster API-Aufruf funktioniert, binden Sie die APIs ein, die zu Ihrem Szenario passen.
| Szenario | Empfohlene APIs | Dokumentation |
|---|---|---|
| Agent für Suche und Recherche | Chat, Web Fetch, X Search, YouTube Subtitling, LiveDocs | Chat API |
| Agent für Office-Produktivität | PPT Task, Mindmap, LiveDocs, SuperAgent | PPT Task API |
| Agent für kreative Abläufe | Landing Page, Bild-Workflows, Web Fetch, Search, SuperAgent | Landing Page API |
| Full-Stack-KI-App | LLM API, Chat, LiveDocs, Web Fetch, SuperAgent | LLM API |
| Wissens-Workflow | LiveDocs, Web Fetch, Chat, SuperAgent | LiveDoc API |
Direkte API-Beispiele
Wenn Sie direkt gegen die API entwickeln, statt ein KI-Tool zu konfigurieren, beginnen Sie mit einem dieser minimalen Aufrufe.
PPT-Aufgabe erstellen
Verwenden Sie die PPT Task API, wenn Sie einen Foliensatz asynchron erzeugen möchten. Die Antwort liefert eine task_id, die Sie abfragen können.
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"
}'Beispielantwort:
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
"livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
"ppt_business_id": "BfLPuQKmChk9SPmyQawxgr"
}
}Fragen Sie den Aufgabenstatus ab:
curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
-H "Authorization: Bearer $FELO_API_KEY"Landing-Page-Aufgabe erstellen
Verwenden Sie die Landing Page Task API, wenn Felo aus einem Prompt eine Landing Page erzeugen soll.
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"
}'Beispielantwort:
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
"thread_short_id": "9qiLTmT77fA3aVurrMHvRJ"
}
}Fragen Sie denselben Aufgabenstatus-Endpoint ab, den auch PPT-Aufgaben verwenden:
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);Häufige Einrichtungsprobleme
| Problem | Was Sie prüfen sollten |
|---|---|
UNAUTHORIZED | Prüfen Sie, ob der Schlüssel korrekt kopiert, nicht widerrufen und als Authorization: Bearer $FELO_API_KEY gesendet wurde |
| Das Tool ruft den falschen Anbieter auf | Prüfen Sie, ob der Felo-Anbieter im aktuellen Workspace oder in der aktuellen Sitzung ausgewählt ist |
| OpenAI-kompatibler Client schlägt fehl | Verwenden Sie https://openapi.felo.ai/api/v1 als Base-URL |
| Anthropic-kompatibler Client schlägt fehl | Verwenden Sie https://openapi.felo.ai/api als Base-URL |
| Asynchrone Aufgabe hat noch kein Ergebnis | Fragen Sie den Aufgabenstatus-Endpoint ab, bis die Aufgabe abgeschlossen ist |