# Gemini API: erros de restrição regional, nível gratuito e permissões da chave API > Como distinguir 403 Access Restricted, 400 FAILED_PRECONDITION e 403 PERMISSION_DENIED com base no texto do erro e nas condições aplicáveis. Source: https://ailoot.ai/blog/pt-pt/gemini-api-access-errors/ Canonical: https://ailoot.ai/blog/pt-pt/gemini-api-access-errors/ Language: pt-PT Publisher: Ailoot (https://ailoot.ai/) Translation: guide-096 Revision: sha256-2b11628521d5908454ba283f436e6725d395fa6f89dea3c466e45847e9b1cf0c Mas nem todos os erros do Gemini estão relacionados com a sua região. Um diz respeito ao nível gratuito; outro, à própria chave da API. E, para programar, o Gemini parece-me um pouco limitado, embora já lhe tenha dado uma segunda oportunidade mais do que uma vez. Vou explicar como perceber o que aconteceu através da mensagem de erro e o que usar em vez do Gemini. Vamos a isso. Para obter informações sobre como utilizar o serviço, consulte a [documentação da Ailoot](https://ailoot.ai/docs/).
Ideia principal 403 Access Restricted significa que os termos de acesso foram violados. 400 FAILED_PRECONDITION significa que o nível gratuito não está disponível no país. 403 PERMISSION_DENIED com uma mensagem sobre as permissões da chave significa que está a usar a chave errada. Para programar, use Claude Code; se não resultar, use Codex e, depois, Qwen ou DeepSeek.
## Como verificar as regiões suportadas pelo Gemini? A Google mantém uma página separada com a lista dos locais onde o Gemini API e o Google AI Studio funcionam:

O Gemini API e o Google AI Studio estão disponíveis nos seguintes países e territórios. Se não estiver num destes países ou territórios, experimente o Gemini API na Gemini Enterprise Agent Platform

https://ai.google.dev/gemini-api/docs/available-regions
Tradução: «O Gemini API e o Google AI Studio estão disponíveis nos seguintes países e territórios. Se não estiver em nenhum deles, experimente o Gemini API na Gemini Enterprise Agent Platform.» A lista contém 230 entradas, da Albânia às Ilhas Åland. A Gemini Enterprise Agent Platform é uma plataforma Google Cloud. Se for redirecionado para esta página em vez do AI Studio, a Google indica 3 motivos: a sua região, ter menos de 18 anos e a idade não estar verificada na sua conta Google. ## 403 Access Restricted: o que tem a sua região a ver com isto? A Google descreve o erro da seguinte forma:

Se vir o erro 403 Access Restricted, está a utilizar o Google AI Studio de uma forma que não cumpre os Termos de Serviço. Um motivo comum é não estar numa região suportada.

https://ai.google.dev/gemini-api/docs/troubleshoot-ai-studio
Tradução: «Se vir o erro 403 Access Restricted, está a utilizar o Google AI Studio de uma forma que viola os Termos de Serviço. Um motivo comum é não estar numa região suportada.» A sua região é uma de 4 verificações. As outras 3 são: - o pedido tem de passar verificações de segurança automatizadas; - tem de aceitar os Termos de Serviço da Google e os termos adicionais para IA generativa; - o projeto Google Cloud não pode estar sinalizado por violações. ## 400 FAILED_PRECONDITION e o nível gratuito Este erro diz respeito a dinheiro. Eis a mensagem que consta da tabela de erros do Gemini API:

O nível gratuito do Gemini API não está disponível no seu país. Ative a faturação do seu projeto no Google AI Studio.

https://ai.google.dev/gemini-api/docs/generate-content/api-errors
Tradução: «O nível gratuito do Gemini API não está disponível no seu país. Ative a faturação do seu projeto no Google AI Studio.» A Google recomenda ativar um plano pago no AI Studio. Mas isso só funciona nos países que constam da lista. ## 403 PERMISSION_DENIED: leia a mensagem O número é o mesmo, mas a mensagem na tabela de erros é diferente:

A sua chave de API não tem as permissões necessárias.

https://ai.google.dev/gemini-api/docs/generate-content/api-errors
Tradução: «A sua chave de API não tem as permissões necessárias.» Segundo a Google, as causas podem ser a escolha da chave errada ou o acesso a um modelo ajustado sem a autorização necessária. Verifique se a chave está correta e se tem acesso. No entanto, no AI Studio, o mesmo erro PERMISSION_DENIED também ocorre durante a verificação da região: a Google descreve esta situação na página sobre as 4 verificações. Por isso, leia a mensagem. Se mencionar as permissões da chave, verifique a chave. Se mencionar a sua região, a chave não tem nada a ver com o problema. ## Vale a pena continuar a usar o Gemini? Para programar, não me parece. Tenho o Gemini no plano de nível mais elevado, mas não desenvolvo programas com ele. Uso-o para vídeos e fotografias. Passei um mês a trabalhar no Google Antigravity, o programa da Google para trabalhar com código, e acabei por voltar ao VS Code. Não importa que o Gemini consiga manter 1 milhão de tokens na memória: é um pouco menos inteligente do que o ChatGPT. O Antigravity não é estúpido e gosto dele, mas a qualidade continua a ser muito pior, infelizmente. Se não houver mais nada disponível, serve: ter alguma coisa é melhor do que nada. O Gemini é bom a fazer investigação aprofundada sobre um tema na Internet. Afinal, é a Google: percorre todos os sites e todos lhe dão acesso. É por isso que faço este tipo de investigação no Gemini em vez de no Claude: o Claude é caro e consome muitos tokens. Mas tenha em conta que o Gemini escreve muito, alonga-se e não consegue identificar o ponto principal. ## O que usar em vez do Gemini A minha ordem é a seguinte. Claude Code, porque é simplesmente mais inteligente. Para quê escolher um modelo menos inteligente quando o mais inteligente está disponível? Se não conseguir fazê-lo funcionar, use o ChatGPT Codex: é mais fácil obter acesso e há menos bloqueios. Se também não resultar, há modelos chineses. O vídeo compara outros modelos para vibe coding:
O vídeo será carregado à medida que percorre a página
Outros modelos para vibe coding: Codex, Gemini, Qwen e criadores de aplicações
Inclui Codex, Gemini, Qwen, Cursor, Lovable, Bolt e v0, e explica a escolha do Claude Code no exemplo de trabalho descrito. **Qwen.** O Qwen é um modelo chinês. Fica cerca de 10% atrás do Opus, o modelo mais forte do Claude; é bastante bom, mas lento. Também o uso, sobretudo para verificar se o código tem erros. Expliquei como o configurar [num artigo separado](https://ailoot.ai/blog/pt-pt/qwen-code-token-plan-setup/). **DeepSeek.** É uma plataforma chinesa. Mas não consegue lidar com uma tarefa que dure várias horas: experimentei e acaba por falhar a meio. Expliquei em que difere do ChatGPT [num artigo separado](https://ailoot.ai/blog/pt-pt/chatgpt-vs-deepseek/). Expliquei que modelo escolher para cada tarefa para evitar pagar demasiado [num artigo separado](https://ailoot.ai/blog/pt-pt/ai-model-for-each-task/). ## Se o Gemini fizer parte do seu produto Inclua desde o início um modelo de recurso. No caso descrito, foi utilizada a API oficial do ChatGPT e a conta foi bloqueada: o serviço tinha processado texto de um utilizador que continha comentários ofensivos. O utilizador nem chegou a saber do bloqueio, porque, ao receber uma recusa, o serviço mudou para um modelo chinês. Pode encontrar uma análise semelhante do erro de região do Claude Code [num artigo separado](https://ailoot.ai/blog/pt-pt/claude-code-region-unavailable/). Se o Gemini e o Claude não estiverem disponíveis na sua região, compare as alternativas disponíveis para a sua tarefa.
### Fontes - [Google: Regiões disponíveis para o Gemini API e o Google AI Studio](https://ai.google.dev/gemini-api/docs/available-regions) - uma lista de 230 países e territórios, 3 motivos para ser encaminhado para a página e a Gemini Enterprise Agent Platform para países fora da lista. - [Google: Resolver problemas do Google AI Studio](https://ai.google.dev/gemini-api/docs/troubleshoot-ai-studio) - o erro 403 Access Restricted e 4 verificações de acesso durante as quais pode ocorrer PERMISSION_DENIED. - [Google: Erros da API](https://ai.google.dev/gemini-api/docs/generate-content/api-errors) - 400 FAILED_PRECONDITION para o nível gratuito e 403 PERMISSION_DENIED por falta de permissões da chave.
Conheça a [Ailoot](https://ailoot.ai/). ## Perguntas frequentes ### Todo o erro 403 do Gemini significa que o país não é suportado? Não. Leia a mensagem completa. O acesso ao AI Studio verifica região, idade e condições da conta; um PERMISSION_DENIED sobre permissões da chave exige verificar a chave escolhida e o seu acesso. ### O que verifico se o nível gratuito devolver FAILED_PRECONDITION? Confirme se o nível gratuito da Gemini API está disponível no país e projeto. Não confunda essa restrição com uma chave inválida; o artigo liga às páginas Google de regiões e resolução do erro específico. ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.