Códigos de error de la API
Son errores de lógica de negocio que devuelve la API de LK Creator cuando una petición es válida pero no se puede atender.
Tabla de códigos
Las columnas de mensaje reproducen el texto exacto que muestra la aplicación.
| Código | Mensaje (EN) | Mensaje (ES) | Cuándo salta | Cómo arreglarlo |
|---|---|---|---|---|
FREE_TIER_LIMIT | You’ve run out of free tokens. Upgrade to Pro for unlimited access. | Te has quedado sin tokens gratuitos. Mejora a Pro para acceso ilimitado. | El usuario gratuito pasa su uso diario | Espera a mañana o pásate a Pro |
DAILY_ITEM_LIMIT_REACHED | You’ve used all your daily tokens. Come back tomorrow or upgrade your plan. | Has usado todos tus tokens diarios. Vuelve manana o mejora tu plan. | Se ha alcanzado el límite diario (12 generaciones + 12 conversiones en Free) | Espera al reinicio (medianoche UTC) o mejora el plan |
INSUFFICIENT_ITEMS | Insufficient tokens for this operation. Remove some items or upgrade to Pro. | Tokens insuficientes para esta operacion. Elimina algunos items o mejora a Pro. | La petición por lotes pasa de los tokens diarios que quedan | Reduce el número de items o mejora el plan |
BATCH_NOT_AVAILABLE | Batch generation is only available for Pro users. | La generacion en lote esta disponible solo para usuarios Pro. | Un usuario gratuito intenta generar por lotes | Usa el modo individual o mejora el plan |
DEV_MODE_NOT_AVAILABLE | Developer Mode is only available for Pro users. | El modo desarrollador esta disponible solo para usuarios Pro. | Un usuario gratuito intenta entrar en Developer Mode | Pásate a Pro |
RATE_LIMITED | Too many requests. Please wait a few moments before trying again. | Demasiadas solicitudes. Por favor espera unos momentos. | Demasiadas llamadas a la API en poco tiempo | Espera unos segundos y reinténtalo |
INVALID_FILENAME | The filename is not valid. | El nombre del archivo no es valido. | El nombre del archivo tiene caracteres no válidos | Usa solo letras, números, guiones bajos, guiones y puntos |
Entender los límites de uso
Desde la v4.7, LK Creator usa cupos de uso independientes:
- Cupo de generación: 12 items al día (plan gratuito)
- Cupo de conversión: 12 conversiones al día (plan gratuito)
- Con Pro: ilimitado en los dos cupos
Los cupos se reinician a medianoche UTC cada día.
Gestionar los errores desde código
Si te integras directamente con la API de LK Creator (Developer Mode), las respuestas de error siguen este formato:
{
"detail": {
"message": "Human-readable message",
"code": "ERROR_CODE",
"daily_limit": 12,
"remaining": 0,
"items_requested": 5
}
}El campo code corresponde a los códigos de error de la tabla de arriba.