# Configuration de l'API Felo

Configurez les points de terminaison Felo dans Data API pour la recherche, le contenu web, les données X et les présentations, en utilisant le solde de plateforme.

Felo est un fournisseur parmi d'autres dans [Data API](https://openapi.felo.ai/fr/docs/data-api), offrant la recherche web, la lecture web, les données X, des réponses ancrées sur la recherche et des présentations. Retrouvez chaque point de terminaison Felo avec les autres fournisseurs dans la catégorie Data API concernée.

Ces points de terminaison utilisent **le solde de plateforme** et le préfixe `/api/v1/data`. Ce guide explique l'authentification, votre première requête et où trouver les règles de facturation.

Pour utiliser les crédits Felo Pro, consultez les [APIs Felo existantes](https://openapi.felo.ai/fr/docs/api-reference/felo-apis.md). Le solde de plateforme et les crédits Pro sont distincts.

## Faites votre première requête

1. Créez une clé dans [Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. Vérifiez ou rechargez votre **solde de plateforme** dans [Console → Billing](https://openapi.felo.ai/console/billing).
3. Définissez la clé sur votre serveur ou dans votre shell local :

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

Envoyez `Authorization: Bearer $FELO_API_KEY`. `X-API-Key` est aussi accepté ; choisissez une seule méthode d'authentification. Les requêtes JSON nécessitent `Content-Type: application/json`.

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What is retrieval augmented generation?","count":3}'
```

HTTP 200 renvoie un tableau `resources` avec les titres des pages, les liens et les extraits, ainsi que `total`. Cela ne génère pas de réponse conversationnelle ; utilisez [Chat](https://openapi.felo.ai/fr/docs/data-api/guides/felo-chat.md) pour cela.

## Explorez les APIs

| Guide | Opérations | Ce que vous recevez | Unité de facturation |
|---|---|---|---|
| [Recherche Web](https://openapi.felo.ai/fr/docs/data-api/guides/felo-web-search.md) | Rechercher le web | Titres de pages, liens et extraits | Requête |
| [Lecture Web](https://openapi.felo.ai/fr/docs/data-api/guides/felo-web-read.md) | Lire une URL | Markdown, texte, HTML ou capture d'écran | Requête |
| [Données X](https://openapi.felo.ai/fr/docs/data-api/guides/felo-x-data.md) | Profils, recherche d'utilisateurs, publications d'utilisateurs, recherche de publications, réponses | Utilisateurs et publications structurés, avec pagination lorsque prise en charge | Résultat retourné |
| [Chat ancré sur la recherche](https://openapi.felo.ai/fr/docs/data-api/guides/felo-chat.md) | Répondre à une question | Réponse et sources web | Requête |
| [PPT](https://openapi.felo.ai/fr/docs/data-api/guides/felo-ppt.md) | Créer, statut, résultats, export, statut d'export, suppression | Tâche de génération et PPTX téléchargeable | Page générée ; export facturé séparément |
| [Facturation et erreurs](https://openapi.felo.ai/fr/docs/data-api/guides/felo-billing.md) | Conseils d'intégration partagés | Tarifs, gestion du solde et règles de nouvelle tentative | — |

Il existe **14 opérations principales** dans ces guides. Si la création PPT renvoie une `stream_key`, le [guide PPT](https://openapi.felo.ai/fr/docs/data-api/guides/felo-ppt.md#lire-les-v-nements-de-g-n-ration-avec-sse) explique aussi comment lire les événements de génération avec SSE. Les requêtes de statut et de résultat, les requêtes de statut d'export et la suppression ne créent pas de nouveau frais.

## Avant de migrer une intégration existante

Utilisez le guide correspondant au point de terminaison exact que vous appelez. Remplacer `/v2` par `/api/v1/data` n'est pas une migration complète :

- Web Read utilise `/web/read`, avec un seul format de sortie par requête.
- Chat renvoie `status: "ok"` ; il prend uniquement en charge le JSON non diffusé.
- Les résultats PPT utilisent **POST** `/tasks/{task_id}/historical`.
- La création PPT renvoie les identifiants à la racine JSON. Conservez à la fois `task_id` et `ppt_business_id`.
- Les PPT générés expirent après sept jours. Exportez et enregistrez votre fichier avant expiration.

Il n'existe ici aucune équivalence OpenAPI native documentée pour tous les workflows `/v2`, tels que CRUD LiveDoc, Mindmap ou SuperAgent. Continuez à utiliser leurs [guides d'APIs Felo](https://openapi.felo.ai/fr/docs/api-reference/felo-apis.md) et la facturation par crédits Pro.

## Contrat et prix actuels

- [Schéma OpenAPI publié](https://openapi.felo.ai/api/v1/data/openapi.json) — définitions des champs et schémas de réponse.
- [Schéma YAML OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.yaml) — pour les outils qui acceptent YAML.
- [Prix actuels](https://openapi.felo.ai/api/v1/data/prices) — identifiants d'opération, unités de facturation et tarifs actuels.

Ces ressources sont publiques et peuvent être lues sans clé. Consultez [Facturation et erreurs](https://openapi.felo.ai/fr/docs/data-api/guides/felo-billing.md) avant d'ajouter des nouvelles tentatives automatiques.