Aan de slag
Aan de slag
Vraag een API-sleutel aan, kies een AI-tool, open de bijbehorende installatiehandleiding en voer je eerste workflow-API-aanroep uit.
Felo API Platform geeft je één API-sleutel voor agenttools, modelprotocollen, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page en de SuperAgent API's. Begin hier, kies de tool die je gebruikt en volg daarna de speciale installatiegids van die tool.
Nieuw hier? Lees het platformoverzicht om te zien hoe de Model API, Data API en Felo API's samenhangen, of ga direct naar Protocollen en SDK's en Kanalen en providerroutering.
Codex of Claude Code configureren met de CLI
Zorg dat Node.js 22+ en je AI-tool zijn geïnstalleerd en voer uit:
npx feloapi-cli setupVolg de prompts om je volledige Felo API-sleutel te plakken en kies modellen, Skills of beide. Start je tool daarna met npx feloapi-cli run codex of npx feloapi-cli run claude-code.
Snelstartproces
- Haal een Felo API Platform-sleutel en koop indien nodig service-tegoed; een abonnement is niet nodig.
- Kies hieronder je AI-tool of platform.
- Open de bijbehorende installatiegids en plak de Felo base-URL en API-sleutel.
- Voer een kleine taak uit in die tool om de verbinding te controleren.
- Voeg workflow-API's toe wanneer je agent zoeken, office-uitvoer, webextractie, imageworkflows, LiveDocs of SuperAgent nodig heeft.
Stap 1: je API-sleutel ophalen
Felo API Platform gebruikt één API-sleutel voor rechtstreekse API-aanroepen en ondersteunde AI-tools.
- Open de pagina API-sleutels van Felo API Platform.
- Log in met je Felo-account als daarom wordt gevraagd.
- Voer een naam voor de sleutel in en klik op Create Key.
- Kopieer de volledige sleutel zodra die verschijnt. De sleutel wordt maar één keer getoond.
- Bewaar de sleutel veilig en gebruik hem als
FELO_API_KEY.
Waardeer gaandeweg op in Console Billing, vanaf $1. Je koopt service-tegoed in Amerikaanse dollars voor daadwerkelijk API-gebruik. Een abonnement is niet nodig.
Stel de sleutel in als omgevingsvariabele:
export FELO_API_KEY="YOUR_API_KEY"Windows PowerShell:
$env:FELO_API_KEY="YOUR_API_KEY"Stap 2: kies je AI-tool
Klik op de tool die je wilt gebruiken. Elke link opent een speciale installatiegids met de juiste base-URL, omgevingsvariabelen en verificatiestap.
| Tool | Geschikt voor | Installatiegids |
|---|---|---|
| Codex | CLI-codeerworkflows, code review, wijzigingen in repositories en automatisering | Codex instellen |
| Claude Code | Coderen met agents, repositories bewerken, ontwikkelen met onderzoeksondersteuning en werk met een lange context | Claude Code instellen |
| OpenCode | Codeersessies in de terminal en routering naar OpenAI-compatibele providers | OpenCode instellen |
| OpenClaw | Workflows voor een persoonlijke AI-assistent en lokale agents | OpenClaw instellen |
| Hermes Agent | Experimenten met agents en orkestratie van meerdere tools | Hermes Agent instellen |
| TRAE | Workflows in een AI-IDE en bewerken met ondersteuning | TRAE instellen |
| OpenViking | Experimenten met agents en wisselen van provider | OpenViking instellen |
| Cursor | AI-coderen in een editor | Cursor instellen |
| Cline | Agentworkflows in VS Code en coderen met hulp van de terminal | Cline instellen |
| Roo Code | Codeeragents in VS Code en taakplanning | Roo Code instellen |
| Kilo Code | Lokale codeeragents en het testen van modelproviders | Kilo Code instellen |
| Andere AI-tools | Elke client die een eigen API-sleutel, base-URL en modelnaam accepteert | Andere tools instellen |
Stap 3: gebruik de juiste base-URL
De meeste tools vragen om drie waarden: API-sleutel, base-URL en modelnaam. Kies de base-URL op basis van het protocol dat de tool ondersteunt.
| De tool vraagt om | Gebruik deze waarde |
|---|---|
| API-sleutel | Je FELO_API_KEY |
| OpenAI-compatibele base-URL | https://openapi.felo.ai/api/v1 |
| Anthropic-compatibele base-URL | https://openapi.felo.ai/api |
| Model-ID | Kies een momenteel beschikbaar ID uit de modelcatalogus |
Weet je niet zeker welke modus je client ondersteunt? Begin dan met de OpenAI-compatibele base-URL. Gebruik de Anthropic-compatibele base-URL voor Claude Code of clients die expliciet om een Anthropic Messages-endpoint vragen.
Stap 4: verifiëren met een rechtstreekse API-aanroep
Wil je alleen controleren of je sleutel werkt? Roep de Chat API dan rechtstreeks aan.
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"
}'Een geslaagde respons bevat een antwoord, query-analyse en webresources.
{
"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": "..."
}
]
}
}Stap 5: workflow-API's toevoegen
Zodra je eerste tool of API-aanroep werkt, koppel je de API's die bij je scenario passen.
| Scenario | Aanbevolen API's | Documentatie |
|---|---|---|
| Agent voor zoeken en onderzoek | Chat, Web Fetch, X Search, YouTube Subtitling, LiveDocs | Chat API |
| Agent voor officeproductiviteit | PPT Task, Mindmap, LiveDocs, SuperAgent | PPT Task API |
| Agent voor creatieve werkzaamheden | Landing Page, imageworkflows, Web Fetch, Search, SuperAgent | Landing Page API |
| Full-stack-AI-app | LLM API, Chat, LiveDocs, Web Fetch, SuperAgent | LLM API |
| Kennisworkflow | LiveDocs, Web Fetch, Chat, SuperAgent | LiveDoc API |
Rechtstreekse API-voorbeelden
Bouw je rechtstreeks op de API in plaats van een AI-tool te configureren? Begin dan met een van deze minimale aanroepen.
Een PPT-taak aanmaken
Gebruik de PPT Task API als je asynchroon een presentatie wilt genereren. De respons bevat een task_id die je kunt pollen.
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"
}'Voorbeeldrespons:
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
"livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
"ppt_business_id": "BfLPuQKmChk9SPmyQawxgr"
}
}Poll de taakstatus:
curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
-H "Authorization: Bearer $FELO_API_KEY"Een landingpaginataak aanmaken
Gebruik de Landing Page Task API als je wilt dat Felo een landingpagina genereert op basis van een prompt.
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"
}'Voorbeeldrespons:
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
"thread_short_id": "9qiLTmT77fA3aVurrMHvRJ"
}
}Poll hetzelfde endpoint voor de taakstatus dat PPT-taken gebruiken:
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);Veelvoorkomende installatieproblemen
| Probleem | Wat je moet controleren |
|---|---|
UNAUTHORIZED | Controleer of de sleutel correct is gekopieerd, niet is ingetrokken en wordt meegestuurd als Authorization: Bearer $FELO_API_KEY |
| De tool roept de verkeerde provider aan | Controleer of in de huidige workspace of sessie de Felo-provider is geselecteerd |
| OpenAI-compatibele client werkt niet | Gebruik https://openapi.felo.ai/api/v1 als base-URL |
| Anthropic-compatibele client werkt niet | Gebruik https://openapi.felo.ai/api als base-URL |
| Asynchrone taak heeft nog geen resultaat | Poll het endpoint voor de taakstatus totdat de taak is voltooid |