Referencia de Errores
Cada código de error de Draftly — qué significa y cómo resolverlo exactamente.
Errores de Generación de Sitios
| Código | Mensaje | Causa | Solución |
|---|---|---|---|
insufficient_credits | Sin créditos | Límite mensual alcanzado | Actualice el plan o espere el reinicio mensual |
prompt_too_vague | Prompt demasiado corto | Menos de 10 palabras o sin contenido real | Añada más detalles específicos |
server_busy | Servidor ocupado, intente de nuevo | Proveedor de IA 503 (Google / Anthropic) | Espere 60 segundos y reintente |
model_timeout | Generación agotó el tiempo | La IA tardó más de 5 minutos | Reintente; simplifique el prompt si se repite |
auth_error | Autenticación requerida | Sesión caducada | Actualice la página e inicie sesión de nuevo |
firestore_error | Error al guardar | Error de escritura en la base de datos | Verifique la conexión; reintente |
generation_failed | Error de generación | Error inesperado de IA | Reintente una vez; contacte a soporte si persiste |
unknown | Error inesperado | No clasificado | Actualice y reintente; incluya el ID del proyecto al contactar a soporte |
Errores de Créditos y Plan
| Error | Causa | Solución |
|---|---|---|
| "Créditos insuficientes" en el chat | Créditos agotados a mitad de sesión | Actualice para continuar; o espere el reinicio mensual |
| "Límite de sitios alcanzado" | Se alcanzó el máximo de sitios para el plan este mes | Espere el reinicio o actualice el plan |
| "Límite de chat alcanzado" | Se agotaron todas las ediciones de chat mensuales | La edición en línea y la edición de código siguen siendo gratuitas |
| "Resolución no disponible" | 2K/4K solicitado en Básico/Pro | Premium+ requerido para 2K/4K |
| "Video no disponible" | Plan gratuito después de 1 clip | Actualice a Básico para video ilimitado |
Errores de Video y Fotogramas
| Error | Causa | Solución |
|---|---|---|
| Extracción de fotogramas omitida — tiempo de espera agotado | Problema de códec de video o decodificación lenta | El sitio vuelve a paralaje estático; regenere el video para reintentar |
| Tiempo de espera agotado en la generación de video | Cola de Veo sobrecargada | Reintente con calidad Relajada (más capacidad de cola) |
| "Video atascado" | Decodificación de video no disponible en el navegador | Use Chrome; Safari puede tener limitaciones de decodificador |
| URL de video caducada | URL firmada caducó antes de la extracción | Reabra el proyecto — el sistema lo vuelve a buscar automáticamente |
Errores de Autenticación
| Error | Causa | Solución |
|---|---|---|
| "Autenticación requerida" | JWT caducado o faltante | Actualice e inicie sesión de nuevo |
| "Desajuste de usuario" | Conflicto de UID de token / cuerpo | Cierre sesión y vuelva a iniciarla |
| Sesión caducada | La sesión de Firebase agotó el tiempo | Inicie sesión de nuevo — el trabajo se guarda automáticamente |
| "Suscripción no activa" | Pago fallido, período de gracia terminado | Actualice el pago en Configuración → Facturación |
Errores de Publicación
| Error | Causa | Solución |
|---|---|---|
| "Subdominio ocupado" | Otro usuario posee este slug | Elija un subdominio diferente |
| "Subdominio inválido" | Contiene caracteres no válidos o palabra reservada | Solo letras, números, guiones; evite palabras reservadas |
| "Publicación fallida" | Error de Firebase Storage o Cloudflare | Reintente; contacte a soporte si persiste |
| Dominio personalizado no se resuelve | DNS no propagado | Espere hasta 48h; verifique que el CNAME esté configurado correctamente |
Obtener Ayuda
Si un error persiste después de los pasos anteriores:
1.Copie su ID de Proyecto — visible en la URL del navegador:
?projectId=proj_XXXXX2.Anote el mensaje de error y qué acción lo desencadenó
3.Envíe un correo electrónico a soporte a support@draftly.business con su ID de Proyecto y una descripción
El soporte suele responder en un plazo de 24 horas en días hábiles.