Referencia de Errores
Cada código de error de Draftly — qué significa y exactamente cómo resolverlo.
Errores de Generación de Sitio
| Código | Mensaje | Causa | Solución |
|---|---|---|---|
insufficient_credits | Sin créditos | Límite mensual alcanzado | Actualiza el plan o espera el reinicio mensual |
prompt_too_vague | Prompt demasiado corto | Menos de 10 palabras o sin contenido real | Agrega más detalle específico |
server_busy | Servidor ocupado, inténtalo de nuevo | 503 del proveedor de IA (Google / Anthropic) | Espera 60 segundos y reintenta |
model_timeout | Generación agotó el tiempo | La IA tardó más de 5 minutos | Reintenta; simplifica el prompt si se repite |
auth_error | Autenticación requerida | Sesión expirada | Actualiza la página e inicia sesión de nuevo |
firestore_error | Error al guardar | Error de escritura en la base de datos | Verifica la conexión; reintenta |
generation_failed | Generación fallida | Error inesperado de IA | Reintenta una vez; contacta soporte si persiste |
unknown | Error inesperado | Sin clasificar | Actualiza y reintenta; incluye el ID del Proyecto al contactar soporte |
Errores de Créditos y Plan
| Error | Causa | Solución |
|---|---|---|
| "Créditos insuficientes" en el chat | Los créditos se agotaron a mitad de sesión | Actualiza para continuar; o espera el reinicio mensual |
| "Límite de sitios alcanzado" | Se alcanzó el máximo de sitios del plan este mes | Espera el reinicio o actualiza el plan |
| "Límite de chat alcanzado" | Se usaron todas las ediciones de chat mensuales | La edición en línea y el editor de código siguen siendo gratuitos |
| "Resolución no disponible" | Se solicitó 2K/4K en Basic/Pro | Se requiere Premium+ para 2K/4K |
| "Video no disponible" | Plan Free después de 1 clip | Actualiza a Basic para video ilimitado |
Errores de Video y Frames
| Error | Causa | Solución |
|---|---|---|
| Extracción de frames omitida — tiempo de espera agotado | Problema de códec de video o decodificación lenta | El sitio recurre a paralaje estático; regenera el video para reintentar |
| Tiempo de espera de generación de video | Cola de Veo sobrecargada | Reintenta con calidad Relajada (mayor capacidad de cola) |
| "Video detenido" | Decodificación de video no disponible en el navegador | Usa Chrome; Safari puede tener limitaciones en el decodificador |
| URL de video expirada | URL firmada expiró antes de la extracción | Reabre el proyecto — el sistema la vuelve a obtener automáticamente |
Errores de Autenticación
| Error | Causa | Solución |
|---|---|---|
| "Autenticación requerida" | JWT expirado o faltante | Actualiza e inicia sesión de nuevo |
| "Error de usuario" | Conflicto de token / UID del cuerpo | Cierra sesión y vuelve a iniciar |
| Sesión expirada | Sesión de Firebase agotada | Inicia sesión de nuevo — el trabajo se guarda automáticamente |
| "Suscripción no activa" | Pago fallido, período de gracia terminado | Actualiza el pago en Configuración → Facturación |
Errores de Publicación
| Error | Causa | Solución |
|---|---|---|
| "Subdominio tomado" | Otro usuario es dueño de este slug | Elige un subdominio diferente |
| "Subdominio inválido" | Contiene caracteres inválidos o palabra reservada | Solo letras, números y guiones; evita palabras reservadas |
| "Publicación fallida" | Error de Firebase Storage o Cloudflare | Reintenta; contacta soporte si persiste |
| Dominio personalizado no resuelve | DNS no propagado | Espera hasta 48h; verifica que el CNAME esté correctamente configurado |
Obtener Ayuda
Si un error persiste después de los pasos anteriores:
1.Copia tu ID de Proyecto — visible en la URL del navegador:
?projectId=proj_XXXXX2.Anota el mensaje de error y qué acción lo desencadenó
3.Envía un correo al soporte a support@draftly.business con tu ID de Proyecto y una descripción
El soporte generalmente responde dentro de 24 horas en días hábiles.