Démarrage
Démarrage
Obtenez une clé API, choisissez un outil d'IA, ouvrez son guide de configuration et effectuez votre premier appel d'API de workflow.
Felo API Platform vous donne une seule clé pour les outils d'agents, les protocoles de modèles, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page et les API SuperAgent. Commencez ici, choisissez l'outil que vous utilisez, puis suivez son guide d'installation dédié.
Vous débutez ? Lisez l'Aperçu de la plateforme pour comprendre comment Model API, Data API et Felo APIs s'articulent, ou allez directement à Protocoles et SDK et Canaux et routage fournisseur.
Configurer Codex ou Claude Code avec la CLI
Avec Node.js 22+ et votre outil IA installé, exécutez :
npx feloapi-cli setupSuivez les invites pour coller votre clé API Felo complète et choisir des modèles, des Skills, ou les deux. Lancez ensuite votre outil avec npx feloapi-cli run codex ou npx feloapi-cli run claude-code.
Installation et utilisation de la CLI
Parcours de démarrage rapide
- Obtenez une clé Felo API Platform et achetez des crédits de service si nécessaire ; aucun abonnement n'est requis.
- Choisissez votre outil ou plateforme IA dans le tableau ci-dessous.
- Ouvrez le guide d'installation correspondant et collez l'URL de base et la clé API Felo.
- Exécutez une petite tâche dans cet outil pour confirmer la connexion.
- Ajoutez les API de workflow lorsque votre agent a besoin de recherche, de sortie bureautique, d'extraction web, de workflows d'images, de LiveDocs ou de SuperAgent.
Étape 1 : obtenir votre clé API
Felo API Platform utilise une seule clé API pour les appels API directs et les outils IA pris en charge.
- Ouvrez la page Clés API de Felo API Platform.
- Connectez-vous avec votre compte Felo si demandé.
- Saisissez un nom de clé et cliquez sur Create Key.
- Copiez la clé complète lorsqu'elle s'affiche. Elle n'est affichée qu'une seule fois.
- Conservez la clé en lieu sûr et utilisez-la comme
FELO_API_KEY.
Rechargez au fur et à mesure dans Console Billing, à partir de 1 $. Vous achetez des crédits de service libellés en USD pour l'utilisation réelle de l'API. Aucun abonnement n'est requis.
Définissez la clé comme variable d'environnement :
export FELO_API_KEY="YOUR_API_KEY"Windows PowerShell :
$env:FELO_API_KEY="YOUR_API_KEY"Étape 2 : choisir votre outil IA
Cliquez sur l'outil que vous souhaitez utiliser. Chaque lien ouvre un guide d'installation dédié avec l'URL de base, les variables d'environnement et l'étape de vérification appropriées.
| Outil | Idéal pour | Guide d'installation |
|---|---|---|
| Codex | Workflows de codage en CLI, revue de code, modifications de dépôt et automatisation | Configurer Codex |
| Claude Code | Codage par agent, édition de dépôt, développement assisté par recherche et travail sur contexte long | Configurer Claude Code |
| OpenCode | Sessions de codage dans le terminal et routage fournisseur compatible OpenAI | Configurer OpenCode |
| OpenClaw | Workflows d'assistant IA personnel et agents locaux | Configurer OpenClaw |
| Hermes Agent | Expérimentations d'agents et orchestration multi-outils | Configurer Hermes Agent |
| TRAE | Workflows d'IDE IA et édition assistée | Configurer TRAE |
| OpenViking | Expérimentations d'agents et changement de fournisseur | Configurer OpenViking |
| Cursor | Codage IA dans un éditeur | Configurer Cursor |
| Cline | Workflows d'agents VS Code et codage assisté par terminal | Configurer Cline |
| Roo Code | Agents de codage VS Code et planification de tâches | Configurer Roo Code |
| Kilo Code | Agents de codage locaux et test de fournisseurs de modèles | Configurer Kilo Code |
| Autres outils IA | Tout client acceptant une clé API personnalisée, une URL de base et un nom de modèle | Configurer d'autres outils |
Étape 3 : utiliser la bonne URL de base
La plupart des outils demandent trois valeurs : la clé API, l'URL de base et le nom du modèle. Choisissez l'URL de base en fonction du protocole pris en charge par l'outil.
| L'outil demande | Utilisez cette valeur |
|---|---|
| Clé API | Votre FELO_API_KEY |
| URL de base compatible OpenAI | https://openapi.felo.ai/api/v1 |
| URL de base compatible Anthropic | https://openapi.felo.ai/api |
| ID de modèle | Choisissez un ID actuellement disponible dans le catalogue de modèles |
Si vous ne savez pas quel mode votre client prend en charge, commencez par l'URL de base compatible OpenAI. Utilisez l'URL de base compatible Anthropic pour Claude Code ou les clients qui demandent explicitement un endpoint Anthropic Messages.
Étape 4 : vérifier avec un appel API direct
Si vous voulez seulement confirmer que votre clé fonctionne, appelez directement le 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"
}'Une réponse réussie comprend la réponse générée, l'analyse de la requête et les ressources web.
{
"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": "..."
}
]
}
}Étape 5 : ajouter des API de workflow
Une fois votre premier outil ou appel API opérationnel, connectez les API correspondant à votre scénario.
| Scénario | API recommandées | Documentation |
|---|---|---|
| Agent de recherche et de veille | Chat, Web Fetch, X Search, YouTube Subtitling, LiveDocs | Chat API |
| Agent de productivité bureautique | PPT Task, Mindmap, LiveDocs, SuperAgent | PPT Task API |
| Agent d'opérations créatives | Landing Page, workflows d'images, Web Fetch, Search, SuperAgent | Landing Page API |
| Application IA full-stack | LLM API, Chat, LiveDocs, Web Fetch, SuperAgent | LLM API |
| Workflow de connaissances | LiveDocs, Web Fetch, Chat, SuperAgent | LiveDoc API |
Exemples d'appels API directs
Si vous développez directement contre l'API au lieu de configurer un outil IA, commencez par l'un de ces appels minimaux.
Créer une tâche PPT
Utilisez le PPT Task API lorsque vous voulez générer une présentation de manière asynchrone. La réponse renvoie un task_id que vous pouvez interroger.
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"
}'Exemple de réponse :
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
"livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
"ppt_business_id": "BfLPuQKmChk9SPmyQawxgr"
}
}Interrogez l'état de la tâche :
curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
-H "Authorization: Bearer $FELO_API_KEY"Créer une tâche de landing page
Utilisez le Landing Page Task API lorsque vous voulez que Felo génère une landing page à partir d'un 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"
}'Exemple de réponse :
{
"status": "ok",
"message": null,
"data": {
"task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
"thread_short_id": "9qiLTmT77fA3aVurrMHvRJ"
}
}Interrogez le même endpoint d'état de tâche que pour les tâches 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);Problèmes d'installation courants
| Problème | À vérifier |
|---|---|
UNAUTHORIZED | Confirmez que la clé est copiée correctement, non révoquée et envoyée en tant que Authorization: Bearer $FELO_API_KEY |
| L'outil appelle le mauvais fournisseur | Vérifiez que le fournisseur Felo est sélectionné dans l'espace de travail ou la session en cours |
| Le client compatible OpenAI échoue | Utilisez https://openapi.felo.ai/api/v1 comme URL de base |
| Le client compatible Anthropic échoue | Utilisez https://openapi.felo.ai/api comme URL de base |
| La tâche asynchrone n'a pas encore de résultat | Interrogez l'endpoint d'état de la tâche jusqu'à ce qu'elle soit terminée |