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.
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
Gardez vos clés d’API confidentielles. Ne les partagez pas dans des zones accessibles au public (GitHub, code côté client, etc.).
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 |
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 minuteX-RateLimit-Remaining : requêtes restantes dans la fenêtre en coursX-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 |
{
"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. 
