Felo API PlatformFelo API Platform

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 setup

Suivez 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

  1. Obtenez une clé Felo API Platform et achetez des crédits de service si nécessaire ; aucun abonnement n'est requis.
  2. Choisissez votre outil ou plateforme IA dans le tableau ci-dessous.
  3. Ouvrez le guide d'installation correspondant et collez l'URL de base et la clé API Felo.
  4. Exécutez une petite tâche dans cet outil pour confirmer la connexion.
  5. 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.

  1. Ouvrez la page Clés API de Felo API Platform.
  2. Connectez-vous avec votre compte Felo si demandé.
  3. Saisissez un nom de clé et cliquez sur Create Key.
  4. Copiez la clé complète lorsqu'elle s'affiche. Elle n'est affichée qu'une seule fois.
  5. 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.

OutilIdéal pourGuide d'installation
CodexWorkflows de codage en CLI, revue de code, modifications de dépôt et automatisationConfigurer Codex
Claude CodeCodage par agent, édition de dépôt, développement assisté par recherche et travail sur contexte longConfigurer Claude Code
OpenCodeSessions de codage dans le terminal et routage fournisseur compatible OpenAIConfigurer OpenCode
OpenClawWorkflows d'assistant IA personnel et agents locauxConfigurer OpenClaw
Hermes AgentExpérimentations d'agents et orchestration multi-outilsConfigurer Hermes Agent
TRAEWorkflows d'IDE IA et édition assistéeConfigurer TRAE
OpenVikingExpérimentations d'agents et changement de fournisseurConfigurer OpenViking
CursorCodage IA dans un éditeurConfigurer Cursor
ClineWorkflows d'agents VS Code et codage assisté par terminalConfigurer Cline
Roo CodeAgents de codage VS Code et planification de tâchesConfigurer Roo Code
Kilo CodeAgents de codage locaux et test de fournisseurs de modèlesConfigurer Kilo Code
Autres outils IATout client acceptant une clé API personnalisée, une URL de base et un nom de modèleConfigurer 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 demandeUtilisez cette valeur
Clé APIVotre FELO_API_KEY
URL de base compatible OpenAIhttps://openapi.felo.ai/api/v1
URL de base compatible Anthropichttps://openapi.felo.ai/api
ID de modèleChoisissez 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énarioAPI recommandéesDocumentation
Agent de recherche et de veilleChat, Web Fetch, X Search, YouTube Subtitling, LiveDocsChat API
Agent de productivité bureautiquePPT Task, Mindmap, LiveDocs, SuperAgentPPT Task API
Agent d'opérations créativesLanding Page, workflows d'images, Web Fetch, Search, SuperAgentLanding Page API
Application IA full-stackLLM API, Chat, LiveDocs, Web Fetch, SuperAgentLLM API
Workflow de connaissancesLiveDocs, Web Fetch, Chat, SuperAgentLiveDoc 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
UNAUTHORIZEDConfirmez 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 fournisseurVérifiez que le fournisseur Felo est sélectionné dans l'espace de travail ou la session en cours
Le client compatible OpenAI échoueUtilisez https://openapi.felo.ai/api/v1 comme URL de base
Le client compatible Anthropic échoueUtilisez https://openapi.felo.ai/api comme URL de base
La tâche asynchrone n'a pas encore de résultatInterrogez l'endpoint d'état de la tâche jusqu'à ce qu'elle soit terminée

Étapes suivantes