Gemini API: erros de restrição regional, nível gratuito e permissões da chave API

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.

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:

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:

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:

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:

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:

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.

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.

Expliquei que modelo escolher para cada tarefa para evitar pagar demasiado num artigo separado.

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.

Se o Gemini e o Claude não estiverem disponíveis na sua região, compare as alternativas disponíveis para a sua tarefa.

Conheça a Ailoot.