Bienvenido a la documentación de la API de LLMGenerator. Nuestra API ofrece acceso programático a las funciones principales de LLMGenerator, para que pueda integrar la generación y la gestión de llms.txt directamente en sus aplicaciones.
URL base
Todos los extremos de la API son relativos a la siguiente URL base:
https://api.llmgenerator.com/api/v1
Autenticación
La API de LLMGenerator utiliza claves API para autenticar las solicitudes. Puede crear y administrar sus claves en Configuración → Claves API.
Todas las solicitudes autenticadas deben incluir un encabezado Authorization con su clave API como token Bearer.
Authorization: Bearer YOUR_API_KEY
Mantenga sus claves API seguras. No las comparta en lugares de acceso público como GitHub, código del lado del cliente, etc.
Métodos de generación
La API admite dos métodos de generación distintos:
| Método | Descripción | Coste en créditos |
|---|
| Simple | Generación rápida usando metadatos de la página. Ideal para resultados inmediatos. | 1x |
| Enhanced | Generación asistida por IA con títulos y descripciones de mayor calidad. | 2x |
Puede indicar el método con el parámetro generationMethod en el extremo /generate. Los usuarios del plan gratuito solo pueden usar el método simple.
Sistema de créditos
El uso de la API se contabiliza mediante créditos:
- Generación simple: coste base en créditos por URL procesada
- Generación enhanced: multiplicador 2x de créditos por el procesamiento con IA
- Texto completo: créditos adicionales si se incluye el contenido completo de la página
Consulte su saldo con el extremo /credits/balance.
Limitación de frecuencia
Las solicitudes a la API tienen límites de frecuencia según su plan de suscripción. Si supera el límite, recibirá una respuesta 429 Too Many Requests. Los encabezados de respuesta incluyen información del límite:
X-RateLimit-Limit: máximo de solicitudes por minuto
X-RateLimit-Remaining: solicitudes restantes en la ventana actual
X-RateLimit-Reset: momento en que se restablece la ventana (epoch UTC en segundos)
Soporte CORS
Los extremos públicos de archivos (/file/:siteId) admiten CORS y pueden usarse directamente desde el navegador. No requieren autenticación.
Errores
La API utiliza códigos de estado HTTP estándar:
| Código | Descripción |
|---|
200 | Éxito |
201 | Recurso creado |
400 | Solicitud incorrecta (error de validación) |
401 | No autorizado (clave API no válida o ausente) |
403 | Prohibido (permisos insuficientes) |
404 | Recurso no encontrado |
429 | Límite de frecuencia superado |
500 | Error interno del servidor |
Las respuestas de error incluyen un cuerpo JSON:
{
"message": "Validation error: URL is required"
}
Webhooks
Para operaciones de larga duración, puede configurar URL de webhook para recibir notificaciones cuando finalicen los trabajos. Contacte con soporte para habilitar webhooks en su cuenta.