API Error Codes
These are business-logic errors returned by the LK Creator API when a request is valid but cannot be fulfilled.
Error Code Table
| Code | Message (EN) | Message (ES) | When It Triggers | How to Fix |
|---|---|---|---|---|
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. | Free user exceeds daily usage | Wait until tomorrow or upgrade to 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. | Daily limit reached (12 gen + 12 conv for Free) | Wait for reset (midnight UTC) or upgrade |
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. | Batch request exceeds remaining daily tokens | Reduce item count or upgrade |
BATCH_NOT_AVAILABLE | Batch generation is only available for Pro users. | La generacion en lote esta disponible solo para usuarios Pro. | Free user attempts batch generation | Use individual mode or upgrade |
DEV_MODE_NOT_AVAILABLE | Developer Mode is only available for Pro users. | El modo desarrollador esta disponible solo para usuarios Pro. | Free user tries to access Developer Mode | Upgrade to Pro |
RATE_LIMITED | Too many requests. Please wait a few moments before trying again. | Demasiadas solicitudes. Por favor espera unos momentos. | Too many API calls in a short period | Wait a few seconds and retry |
INVALID_FILENAME | The filename is not valid. | El nombre del archivo no es valido. | Filename contains invalid characters | Use only letters, numbers, underscores, hyphens, and dots |
Understanding Usage Limits
Since v4.7, LK Creator uses independent usage pools:
- Generation pool: 12 items per day (Free tier)
- Conversion pool: 12 conversions per day (Free tier)
- Pro users: Unlimited for both pools
Pools reset at midnight UTC each day.
Handling Errors in Code
If you’re integrating with the LK Creator API directly (Developer Mode), error responses follow this format:
{
"detail": {
"message": "Human-readable message",
"code": "ERROR_CODE",
"daily_limit": 12,
"remaining": 0,
"items_requested": 5
}
}The code field matches the error codes listed above.