> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmgenerator.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Vue d'ensemble de l'API REST LLMGenerator.

Bienvenue dans la documentation de l'API LLMGenerator. Notre API donne un accès programmatique aux fonctionnalités principales de LLMGenerator, afin d'intégrer la génération et la gestion des fichiers `llms.txt` directement dans vos applications.

## URL de base

Tous les points de terminaison sont relatifs à l'URL de base suivante :

```
https://api.llmgenerator.com/api/v1
```

## Authentification

L'API LLMGenerator utilise des clés d'API pour authentifier les requêtes. Vous pouvez créer et gérer vos clés dans [Paramètres → Clés d'API](https://app.llmgenerator.com/settings/api-keys).

Toute requête authentifiée doit inclure un en-tête `Authorization` avec votre clé d'API en jeton Bearer.

```
Authorization: Bearer YOUR_API_KEY
```

<Warning>
  Gardez vos clés d'API confidentielles. Ne les partagez pas dans des zones accessibles au public (GitHub, code côté client, etc.).
</Warning>

## Méthodes de génération

L'API prend en charge deux modes de génération distincts :

| Méthode      | Description                                                                            | Coût en crédits |
| ------------ | -------------------------------------------------------------------------------------- | --------------- |
| **Simple**   | Génération rapide à partir des métadonnées des pages. Idéal pour un résultat immédiat. | 1x              |
| **Enhanced** | Génération enrichie par l'IA avec titres et descriptions améliorés.                    | 2x              |

Indiquez le mode via le paramètre `generationMethod` sur le point de terminaison `/generate`. Les comptes du plan gratuit ne peuvent utiliser que la méthode `simple`.

## Système de crédits

La consommation de l'API est suivie en crédits :

* **Génération simple** : coût de base en crédits par URL traitée
* **Génération enrichie (Enhanced)** : multiplicateur ×2 pour le traitement IA
* **Texte intégral** : crédits supplémentaires si le contenu intégral des pages est inclus

Consultez votre solde via le point de terminaison `/credits/balance`.

## Limitation du débit

Les requêtes sont limitées en débit selon votre abonnement. Si vous dépassez la limite, vous recevez une réponse `429 Too Many Requests`. Les en-têtes de réponse contiennent les informations de limitation :

* `X-RateLimit-Limit` : nombre maximal de requêtes par minute
* `X-RateLimit-Remaining` : requêtes restantes dans la fenêtre en cours
* `X-RateLimit-Reset` : moment de réinitialisation de la fenêtre (epoch UTC en secondes)

## Prise en charge de CORS

Les points de terminaison publics de fichiers (`/file/:siteId`) prennent en charge CORS et sont accessibles directement depuis les navigateurs. Aucune authentification n'est requise.

## Erreurs

L'API utilise les codes de statut HTTP habituels :

| Code  | Description                                  |
| ----- | -------------------------------------------- |
| `200` | Réussite                                     |
| `201` | Ressource créée                              |
| `400` | Requête incorrecte (erreur de validation)    |
| `401` | Non autorisé (clé d'API absente ou invalide) |
| `403` | Interdit (droits insuffisants)               |
| `404` | Ressource introuvable                        |
| `429` | Limite de débit dépassée                     |
| `500` | Erreur interne du serveur                    |

Les réponses d'erreur incluent un corps JSON :

```json theme={null}
{
  "message": "Validation error: URL is required"
}
```

## Webhooks

Pour les opérations longues, vous pouvez configurer des URL de webhook pour être averti à la fin des tâches. Contactez le support pour activer les webhooks sur votre compte.