Referência de Erros
Cada código de erro do Draftly — o que significa e como resolvê-lo.
Erros de Geração de Site
| Código | Mensagem | Causa | Correção |
|---|---|---|---|
insufficient_credits | Sem créditos | Limite mensal atingido | Atualize o plano ou aguarde a redefinição mensal |
prompt_too_vague | Prompt muito curto | Menos de 10 palavras ou sem conteúdo real | Adicione mais detalhes específicos |
server_busy | Servidor ocupado, tente novamente | Provedor de IA 503 (Google / Anthropic) | Aguarde 60 segundos e tente novamente |
model_timeout | Geração esgotou o tempo | IA levou mais de 5 minutos | Tente novamente; simplifique o prompt se ocorrer novamente |
auth_error | Autenticação necessária | Sessão expirada | Atualize a página e faça login novamente |
firestore_error | Falha ao salvar | Erro de gravação no banco de dados | Verifique a conexão; tente novamente |
generation_failed | Falha na geração | Erro inesperado da IA | Tente novamente uma vez; entre em contato com o suporte se persistir |
unknown | Erro inesperado | Não classificado | Atualize e tente novamente; inclua o ID do Projeto ao entrar em contato com o suporte |
Erros de Crédito e Plano
| Erro | Causa | Correção |
|---|---|---|
| "Créditos insuficientes" no chat | Créditos esgotados no meio da sessão | Faça upgrade para continuar; ou aguarde a redefinição mensal |
| "Limite de sites atingido" | Atingiu o número máximo de sites para o plano este mês | Aguarde a redefinição ou atualize o plano |
| "Limite de chat atingido" | Usou todas as edições de chat mensais | Edição inline e edição de código permanecem gratuitas |
| "Resolução não disponível" | 2K/4K solicitado em Básico/Pro | Premium+ necessário para 2K/4K |
| "Vídeo indisponível" | Plano gratuito após 1 clipe | Faça upgrade para Básico para vídeo ilimitado |
Erros de Vídeo e Frame
| Erro | Causa | Correção |
|---|---|---|
| Extração de frame ignorada — tempo esgotado | Problema de codec de vídeo ou decodificação lenta | O site retorna ao parallax estático; gere o vídeo novamente para tentar |
| Tempo limite de geração de vídeo | Fila do Veo sobrecarregada | Tente novamente com qualidade Relaxada (mais capacidade de fila) |
| "Vídeo travado" | Decodificação de vídeo indisponível no navegador | Use Chrome; Safari pode ter limitações de decodificador |
| URL do vídeo expirou | URL assinado expirou antes da extração | Reabra o projeto — o sistema busca novamente automaticamente |
Erros de Autenticação
| Erro | Causa | Correção |
|---|---|---|
| "Autenticação necessária" | JWT expirado ou ausente | Atualize e faça login novamente |
| "Incompatibilidade de usuário" | Conflito de UID de token / corpo | Saia e faça login novamente |
| Sessão expirada | Sessão do Firebase esgotou o tempo | Faça login novamente — o trabalho é salvo automaticamente |
| "Assinatura não ativa" | Pagamento falhou, período de carência terminou | Atualize o pagamento em Configurações → Cobrança |
Erros de Publicação
| Erro | Causa | Correção |
|---|---|---|
| "Subdomínio em uso" | Outro usuário possui este slug | Escolha um subdomínio diferente |
| "Subdomínio inválido" | Contém caracteres inválidos ou palavra reservada | Apenas letras, números, hífens; evite palavras reservadas |
| "Falha na publicação" | Erro do Firebase Storage ou Cloudflare | Tente novamente; entre em contato com o suporte se persistir |
| Domínio personalizado não resolvendo | DNS não propagado | Aguarde até 48h; verifique se o CNAME está configurado corretamente |
Obtendo Ajuda
Se um erro persistir após as etapas acima:
1.Copie o ID do seu Projeto — visível no URL do navegador:
?projectId=proj_XXXXX2.Anote a mensagem de erro e qual ação a desencadeou
3.Envie um e-mail para o suporte em support@draftly.business com o ID do seu Projeto e uma descrição
O suporte geralmente responde em até 24 horas em dias úteis.