> ## 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.

# Introducción

> Visión general de la API REST de LLMGenerator.

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](https://app.llmgenerator.com/settings/api-keys).

Todas las solicitudes autenticadas deben incluir un encabezado `Authorization` con su clave API como token Bearer.

```
Authorization: Bearer YOUR_API_KEY
```

<Warning>
  Mantenga sus claves API seguras. No las comparta en lugares de acceso público como GitHub, código del lado del cliente, etc.
</Warning>

## 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:

```json theme={null}
{
  "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.