Solução de problemas e perguntas frequentes

Problemas com o painel lateral

“O painel lateral não abre”

Sintoma: você clica no ícone da barra de ferramentas e nada acontece, ou a área do painel lateral à direita do Chrome fica em branco.

Causa provável: versão do Chrome muito antiga. A API do painel lateral requer o Chrome 114 ou mais recente; testamos em relação à versão estável atual.

Correção: abra chrome://settings/help e deixe o Chrome atualizar. Reinicie. Clique no ícone novamente.

“Vejo ‘Abra o Grok para começar’ mesmo estando no grok.com”

Sintoma: o modal não está no Grok aparece com um botão Abrir grok.com/imagine, mesmo que a barra de URL mostre grok.com.

Causa provável: você está em uma subpágina do Grok que a extensão não reconhece como a interface do imagine — por exemplo, grok.com/chat/... ou uma página de configurações.

Correção: clique no botão Abrir grok.com/imagine do modal. Ele leva você a grok.com/imagine, que é a página que o painel lateral monitora.

“O painel está travado em uma tela creme em branco”

Sintoma: o painel lateral abre mas nunca exibe a tela de login ou a interface principal — apenas um fundo creme vazio.

Causa provável: a verificação de sessão está travando. Isso geralmente acontece quando uma janela OAuth de uma tentativa de login anterior ainda está aberta em segundo plano.

Correção: verifique suas janelas do Chrome por um pequeno popup de login do Google. Feche-o. Recarregue o painel lateral clicando no ícone da barra de ferramentas para fechá-lo e depois novamente para reabrir.

Falha genérica de OAuth. Causas mais comuns, em ordem:

Você fechou o popup antes de concluir. Clique em Entrar com Google novamente; o popup reaparecerá.
O navegador bloqueou o popup. Verifique a barra de endereço do Chrome por um ícone “Popup bloqueado”; permita popups para a extensão.
Conta Google errada selecionada. Se sua cota gratuita está em uma conta Google diferente, saia e entre novamente com a conta correta.

Sintoma: você passou pelo fluxo de login da página de boas-vindas mas o painel lateral ainda mostra Entrar com Google.

Correção: o painel detecta automaticamente novos logins via eventos chrome.storage. Se ele não capturou o seu, feche o painel (clique no ícone da barra de ferramentas) e reabra. Agora deve mostrar a interface principal.

Falhas durante a execução

“Cota gratuita esgotada”

O modal de cota esgotada aparece no meio de um lote. O Grok Automation havia pago antecipadamente a cota de um prompt, o próximo prompt não pôde ser processado e a fila parou.

Duas opções:

Upgrade para Pro — clique no botão principal do modal para abrir a página de preços. Após o upgrade, clique em Continuar no painel lateral para retomar os prompts não executados.
Aguarde o reset diário e clique em Continuar mais tarde.

O snapshot é preservado entre reinicializações, então você não precisa manter o painel aberto.

“Limite de taxa do Grok atingido”

O modal de limite de taxa do Grok aparece. Este é o limite do Grok (não nosso) — sua conta xAI atingiu seu limite de geração por hora ou diário no próprio grok.com.

Fazer upgrade para SuperGrok abre a própria página de assinatura do Grok. Após o upgrade, volte ao painel lateral e clique em Continuar.
Entendido descarta o modal. Aguarde o limite do Grok resetar (geralmente uma hora) e clique em Continuar.

Para reduzir a chance de atingir esse limite em lotes longos, aumente o Atraso máx. em Configurações → Fila para 12–20 segundos antes de iniciar. O ritmo mais lento dá tempo para a janela de taxa do Grok esvaziar.

“Execução finalizada com erros” — o que falhou e por quê

Quando um lote termina com badges vermelhos em algumas linhas, clique na linha do prompt para expandir sua mensagem de erro. As mais comuns:

O texto do erro começa com…	O que significa	O que fazer
`timeout`	O Grok demorou mais do que o executor esperou. Geralmente um horário de pico.	Reexecute com Continuar; as tentativas geralmente têm sucesso.
`download failed`	A geração teve sucesso, mas o download automático não conseguiu gravar no disco.	Verifique as configurações de download do Chrome; talvez um diálogo de “Salvar como” esteja aguardando.
`unknown @reference`	(Referência para Vídeo) um prompt usou `@nomedoarquivo` que não corresponde a nenhuma imagem da biblioteca.	Corrija o erro de digitação e reexecute.
`no image attached`	(Imagem para Vídeo / Referência para Vídeo) a biblioteca tem menos imagens do que os prompts precisam.	Adicione mais imagens de referência ou reduza a lista de prompts.
`skipped:`	Uma etapa anterior da cadeia falhou, então esta não tem nada de que encadear.	Reexecute com Continuar — o executor tentará novamente a etapa que falhou e então reencadeará para frente.

Problemas com imagens de referência

“A correspondência automática não está encontrando nada”

Sintoma: em Imagem para Imagem com Associação automática ativada, cada linha mostra o chip de aviso sem correspondência.

Causas prováveis, em ordem:

Nomes de arquivo não aparecem nos prompts. A correspondência automática procura o nome do arquivo (sem extensão) como uma substring do texto do prompt. hero-frontal.png corresponde ao prompt "hero frontal..." mas não a "o herói olha para a frente".
Nomes de arquivo são genéricos demais. image-1.png vai corresponder a qualquer prompt que contenha “image” — e provavelmente ao errado. Renomeie para algo descritivo.
Você pretendia usar o modo manual. Se você não se importa com correspondência por prompt, desative Associação automática — cada prompt recebe as primeiras N imagens independentemente do nome.

“Referência para Vídeo diz `@referência desconhecida`”

Você digitou @hero em um prompt mas a biblioteca não tem imagem cujo nome de arquivo (sem extensão) seja hero. Maiúsculas/minúsculas são ignoradas, mas hífens vs. sublinhados importam — @hero-frontal ≠ hero_frontal.png.

Correção: renomeie o arquivo na sua biblioteca (remova, renomeie no disco, adicione novamente) ou corrija o token @ no seu prompt.

“Minhas imagens carregadas desapareceram após reiniciar o navegador”

Sintoma: a biblioteca de ontem está vazia hoje.

As imagens de referência são armazenadas no estado do componente (não persistidas no chrome.storage) para evitar sobrecarregar o armazenamento local com miniaturas em base64. Elas sobrevivem a reinicializações de abas mas não a reinicializações do navegador. Faça upload novamente no início de cada sessão, ou mantenha sua pasta de biblioteca no disco acessível.

Problemas de download

“O download automático está ativado mas nenhum arquivo aparece na minha pasta”

Três coisas para verificar, em ordem:

O prompt de download do Chrome está aguardando. Abra chrome://downloads — pode haver um diálogo “Salvar como” pendente.
O nome da pasta tem caracteres ilegais. Barras, dois-pontos, espaços iniciais/finais. Use apenas letras, dígitos e hífens.
Você está verificando a pasta errada. O Chrome salva no seu Downloads raiz + a subpasta que você definiu. No macOS é ~/Downloads/<pasta>/; no Windows é %USERPROFILE%\Downloads\<pasta>\.

“Arquivos estão nomeados (1).png, (2).png, etc.”

Sintoma: o Chrome desduplicou seus nomes de arquivo com sufixos (1), (2) porque dois prompts produziram arquivos com nomes idênticos.

Causa provável: Usar o texto do prompt como nome do arquivo está ativado e você tem prompts duplicados no lote. Corrija os duplicados, ou desative o botão — nomes sequenciais (prefixo-001.png) não podem colidir.

Desempenho e ritmo

“Um lote de 50 prompts está demorando uma eternidade”

Esperado. Com o atraso padrão de 2–5 s entre prompts e ~30 s por imagem no tier Velocidade, um lote de 50 imagens leva ~30 minutos no total. Vídeo em 720p dobra esse tempo. Planeje execuções noturnas adequadamente.

Para torná-lo mais rápido (com o risco de limites de taxa), reduza Atraso mín. / Atraso máx. para 1 / 3 em Configurações → Fila. Se você começar a atingir limites de taxa, desfaça essa mudança imediatamente e adicione algum buffer (5 / 12 é uma configuração noturna mais segura).

“As tentativas estão consumindo minha cota”

Se as suas Configurações → Fila → Tentativas por prompt estiverem definidas como 4 e seu lote tem muitos prompts com falha, cada um consome até 5× a cota que você esperava. Reduza as tentativas para 1 ou 2 para execuções sensíveis ao custo.

Ainda travado

Se nenhuma das opções acima resolver seu problema, duas coisas nos ajudam a te ajudar:

Clique no botão Logs no canto inferior direito do rodapé do painel lateral, depois em Exportar logs. Isso gera um arquivo JSON com a atividade recente do executor.
Envie o JSON por e-mail para [email protected] com uma descrição de uma linha do que você estava fazendo quando parou de funcionar. Respondemos em até um dia útil.