Erros de API Gemini
Identificação e solução dos erros mais comuns ao usar a chave de API do Gemini no MyPostFlow. Encontre seu erro abaixo e siga os passos indicados.
Limite da chave de API atingido
Sua chave do Gemini atingiu o limite gratuito de uso. O Google oferece uma cota gratuita por minuto e por dia, e ao ultrapassá-la o serviço bloqueia novas requisições até o reset. Este é o erro mais comum entre novos usuários — e tem solução simples.
Quando aparece
- A mensagem "quota exceeded" ou "RESOURCE_EXHAUSTED" aparece ao tentar gerar um carrossel
- Pode acontecer logo nas primeiras gerações se a chave for nova
- Acontece com mais frequência após várias gerações no mesmo dia
- Costuma resolver sozinho após algumas horas (reset diário automático)
Como resolver
- 1
- 2
Clique em "Create API Key" e gere uma segunda chave — em muitos casos a primeira chave tem cota inicial menor que a segunda
- 3
Copie a nova chave gerada (começa com "AIzaSy...")
- 4
No MyPostFlow, acesse Configurações → aba API & IA, cole a nova chave e clique em Salvar
- 5
Se esta é sua primeira chave e já deu erro, gere uma segunda — na maioria dos casos a segunda chave resolve sem precisar ativar faturamento.
Tema bloqueado pelos filtros do Google
O Gemini possui filtros automáticos de segurança (Safety Filters) que bloqueiam temas que possam soar violentos, adultos, polêmicos ou ofensivos — mesmo quando a intenção é educativa. Esses filtros são aplicados pelo Google e não podem ser desligados pelo MyPostFlow.
Quando aparece
- Mensagem do tipo "content blocked", "safety filter" ou "SAFETY"
- Acontece com temas que mencionam violência, política, religião, sexo ou saúde mental
- Mudar uma ou duas palavras-chave do tema já costuma resolver
- Acontece também em temas comerciais com palavras ambíguas (ex: "matar a concorrência")
Como resolver
- 1
Reformule o tema de forma mais neutra e descritiva
- 2
Evite palavras que possam soar violentas, adultas ou ambíguas — mesmo em sentido figurado
- 3
Ao invés de "como dominar pessoas", tente "como liderar equipes com eficiência"
- 4
Use sinônimos: "vencer" → "alcançar", "destruir" → "superar", "matar" → "resolver"
- 5
Tente novamente com o tema ajustado
Temas educativos, de marketing e negócios raramente são bloqueados quando descritos de forma neutra. Uma pequena reformulação resolve 95% dos casos.
Servidores do Google sobrecarregados
Os servidores do Gemini estão com alta demanda no momento e não conseguem processar sua requisição. Este erro retorna códigos 503 ("UNAVAILABLE") ou 429 ("Too Many Requests") e é completamente temporário — não tem relação alguma com sua chave, conta ou plano.
Quando aparece
- Aparece aleatoriamente mesmo com tudo configurado corretamente
- Mais frequente em horários de pico (manhã nos EUA, tarde no Brasil)
- Some sozinho em poucos minutos
- Pode aparecer logo após o lançamento de uma nova versão do Gemini
Como resolver
- 1
Aguarde 1 a 2 minutos antes de tentar novamente
- 2
Clique em "Tentar novamente" no MyPostFlow
- 3
Se persistir por mais de 10 minutos, verifique o status oficial dos serviços do Google
- 4
Em horário de pico, gere carrosséis com menos slides (5 a 7) para reduzir chance de timeout
Não é necessário alterar nada na conta ou na chave. O MyPostFlow tentará automaticamente os outros 5 modelos Gemini antes de retornar erro definitivo.
A IA retornou um formato diferente do esperado
O Gemini processou sua solicitação com sucesso, mas retornou o conteúdo num formato que o MyPostFlow não conseguiu interpretar — geralmente JSON malformado ou um campo de slide faltando. Costuma acontecer quando o modelo encurta a resposta por limite de tokens.
Quando aparece
- Aparece após o processo de geração quase completar (90%+)
- Mais comum em temas muito longos ou com muitos slides (10+)
- Tende a resolver na segunda tentativa, sem alterar nada
- Pode incluir erros do tipo "JSON parse", "malformed response" ou "missing field"
Como resolver
- 1
Clique em "Tentar novamente" — na maioria dos casos resolve imediatamente
- 2
Se persistir, reduza o número de slides para 5–7
- 3
Reformule o tema de forma mais direta e simples (até 100 caracteres)
- 4
Evite pedir muito detalhamento em cada slide — a IA tende a "atropelar" o JSON
Temas curtos e diretos têm muito menos chance de causar este erro. Carrosséis com 5 a 7 slides são o ponto ideal de qualidade × estabilidade.
A IA não gerou nenhum conteúdo
O Gemini recebeu e processou sua solicitação, mas retornou uma resposta vazia. Geralmente é combinação de tema muito vago com os filtros internos do modelo, que preferem "não responder" a gerar algo ruim.
Quando aparece
- O processo de geração completa mas o carrossel chega vazio
- Mais comum com temas muito curtos ou genéricos (ex: apenas "marketing", "vendas", "produtividade")
- Acontece quando o tema é muito amplo e a IA não tem direção clara
Como resolver
- 1
Torne o tema bem mais específico — combine número + assunto + público
- 2
Exemplo: troque "marketing" por "5 estratégias de marketing digital para pequenos negócios no Instagram em 2026"
- 3
Adicione contexto: para quem é, qual o problema, qual o resultado esperado
- 4
Reduza o número de slides solicitados (5 a 7 funcionam melhor com temas mais específicos)
- 5
Aguarde alguns segundos e tente novamente
Quanto mais contexto e especificidade você dá no tema, melhores e mais consistentes serão os resultados. Complete o Quiz de Identidade para personalizar ainda mais.
Chave de API não reconhecida pelo Google
A chave de API configurada no MyPostFlow não é válida para o Google. Pode ter sido deletada no AI Studio, expirada, copiada com espaços extras, ou estar atrelada a um projeto que teve a API Gemini desabilitada.
Quando aparece
- Mensagem do tipo "API key not valid", "API_KEY_INVALID" ou "permission denied"
- Aparece sempre ao tentar qualquer geração, independente do tema
- Não muda mesmo após várias tentativas
- Pode acontecer se você revogou a chave no Google ou apagou o projeto
Como resolver
- 1
Acesse o Google AI Studio e verifique se sua chave ainda existe
- 2
Se a chave foi deletada, crie uma nova clicando em "Create API Key"
- 3
Copie a chave com cuidado — ela começa com "AIzaSy..." seguido de 35 caracteres alfanuméricos
- 4
Em Configurações → API & IA, apague a chave atual completamente, cole a nova e clique em Salvar
- 5
Confirme que o projeto no Google Cloud está com a "Generative Language API" habilitada
Verifique se a chave foi copiada completa, sem espaços extras no início ou no fim — isso causa 90% dos casos deste erro.
Conexão interrompida durante a geração
A geração foi interrompida antes da resposta completa chegar do Google até o MyPostFlow. Pode ser instabilidade de internet, troca de rede no meio do processo, ou timeout natural para carrosséis muito grandes.
Quando aparece
- O processo fica carregando por muito tempo e desaparece sem resultado
- Aparece mensagem "network error" ou "connection lost"
- Mais comum ao gerar 10 ou mais slides
- Acontece se a aba ficar em segundo plano por muito tempo durante a geração
Como resolver
- 1
Verifique sua conexão com a internet — teste com outro site
- 2
Tente novamente — carrosséis com 5 a 7 slides raramente têm esse problema
- 3
Não feche, atualize, nem troque de aba durante a geração
- 4
Se estiver no celular, prefira conexão Wi-Fi estável a 4G/5G
- 5
Em redes corporativas com firewall, verifique se o domínio do Google está liberado
A geração leva entre 15 e 60 segundos dependendo do tema e número de slides. Mantenha a aba aberta e ativa durante esse período.
Ainda com problema?
Se nenhuma das soluções acima funcionou, abra um chamado no nosso suporte — respondemos em até 24 horas úteis.
Falar com o suporte