Referência de Erros
Todos os códigos de erro do Draftly — o que significa e como resolver.
Erros de Geração de Site
| Código | Mensagem | Causa | Solução |
|---|---|---|---|
insufficient_credits | Sem créditos | Limite mensal atingido | Faça upgrade do 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 com erro 503 (Google / Anthropic) | Aguarde 60 segundos e tente novamente |
model_timeout | Geração expirou | A IA levou mais de 5 minutos | Tente novamente; simplifique o prompt se recorrer |
auth_error | Autenticação necessária | Sessão expirada | Atualize a página e entre novamente |
firestore_error | Falha ao salvar | Erro de escrita no banco de dados | Verifique a conexão; tente novamente |
generation_failed | Falha na geração | Erro inesperado de IA | Tente uma vez; contate o suporte se persistir |
unknown | Erro inesperado | Não classificado | Atualize e tente novamente; inclua o ID do Projeto ao contatar o suporte |
Erros de Crédito e Plano
| Erro | Causa | Solução |
|---|---|---|
| "Créditos insuficientes" no chat | Créditos esgotaram no meio da sessão | Faça upgrade para continuar; ou aguarde a redefinição mensal |
| "Limite de sites atingido" | Atingiu o máximo de sites para o plano neste mês | Aguarde a redefinição ou faça upgrade do 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 no Basic/Pro | Premium+ necessário para 2K/4K |
| "Vídeo indisponível" | Plano Free após 1 clipe | Faça upgrade para Basic para vídeo ilimitado |
Erros de Vídeo e Frames
| Erro | Causa | Solução |
|---|---|---|
| Extração de frame ignorada — timeout | Problema de codec de vídeo ou decodificação lenta | Site recorre à paralaxe estática; regenere o vídeo para tentar novamente |
| Timeout de geração de vídeo | Fila do Veo sobrecarregada | Tente novamente com qualidade Relaxed (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 de vídeo expirada | URL assinada expirou antes da extração | Reabra o projeto — o sistema rebusca automaticamente |
Erros de Autenticação
| Erro | Causa | Solução |
|---|---|---|
| "Autenticação necessária" | JWT expirado ou ausente | Atualize e entre novamente |
| "Incompatibilidade de usuário" | Conflito de UID no token / corpo | Saia e entre novamente |
| Sessão expirada | Sessão do Firebase expirou | Entre novamente — o trabalho é salvo automaticamente |
| "Assinatura não ativa" | Pagamento falhou, período de carência encerrado | Atualize o pagamento em Configurações → Cobrança |
Erros de Publicação
| Erro | Causa | Solução |
|---|---|---|
| "Subdomínio ocupado" | 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 e hífens; evite palavras reservadas |
| "Falha na publicação" | Erro no Firebase Storage ou Cloudflare | Tente novamente; contate 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 seu ID de Projeto — visível na URL do navegador:
?projectId=proj_XXXXX2.Anote a mensagem de erro e qual ação a acionou
3.Envie e-mail para o suporte em support@draftly.business com seu ID de Projeto e uma descrição
O suporte normalmente responde em 24 horas nos dias úteis.