Emitir uma chave de API do Gemini é uma sequência de frustrações

• O processo de emissão da chave de API do Google Gemini 3 Pro é excessivamente complexo, com uma estrutura que dificulta o acesso para desenvolvedores individuais
• O nome Gemini é aplicado de forma duplicada a várias linhas de produtos, o que dificulta distinguir claramente qual serviço oferece qual funcionalidade
• Criar uma chave de API no Google AI Studio é simples, mas o processo de configuração de cobrança migra para o Google Cloud Console e exige procedimentos de autenticação complexos e envio de documentos
• Mesmo após a verificação da conta de cobrança, o erro 403 Forbidden continuou se repetindo, e levou várias horas até chegar a um estado realmente utilizável
• A experiência como um todo mostra procedimentos ineficientes voltados a grandes empresas, em contraste com a abordagem mais enxuta da OpenAI e da Anthropic

---

Confusão na linha de produtos Gemini

• O nome “Gemini” é usado em vários produtos, como chatbot, app móvel, assistente de voz, recursos de IA no Workspace, ferramenta de CLI, extensão de IDE e modelo LLM
  • Exemplos: o chatbot em gemini.google.com, apps para Android/iPhone, Gemini CLI, Gemini Code Assist, Vertex AI Platform etc.
• Como o mesmo nome é usado em vários serviços, surge uma situação em que fica difícil encontrar o caminho de acesso à API para desenvolvedores
• Anthropic e OpenAI, por outro lado, oferecem apenas dois caminhos de acesso: serviço web para consumidores e console para desenvolvedores, mantendo uma estrutura muito mais simples

Processo de criação da chave de API

• No Google AI Studio, criar a chave de API é simples e é possível emitir uma nova chave em poucos segundos
• A chave emitida foi reconhecida normalmente no Gemini CLI, mas era necessário configurar o pagamento de créditos de API pagos
• Ao clicar no link “Set up billing”, ocorre o redirecionamento para o Google Cloud Console, e então começa um processo complexo

Complexidade da configuração da conta de cobrança

• Não é possível fazer um pagamento simples: é preciso passar pelas etapas de criar uma Billing Account → vincular um projeto → adicionar uma forma de pagamento → verificar a forma de pagamento
• Mesmo após a autenticação OTP em duas etapas de um cartão de crédito da Índia, ainda foi exigido o envio de documento de identidade emitido pelo governo e foto do cartão
  • O número do cartão precisava ser ocultado manualmente em um editor de imagens, e o upload aceitava apenas o formato PNG
• Os erros de upload se repetiram, e foi recebido um e-mail informando que a validação poderia levar vários dias

Erro 403 e recuperação da conta

• Mesmo após a validação concluída, o erro 403 Forbidden continuou ocorrendo no Gemini CLI e nas chamadas de API
  • O teste com o código de exemplo em JavaScript da documentação do Google também apresentou o mesmo erro
  • No AI Studio Playground, também apareceu a mensagem “Failed to generate content”
• Só depois de receber um e-mail do Google dizendo “Your account is in good standing” tudo passou a funcionar normalmente
  • Depois disso, Playground, API e CLI passaram todos para um estado em que o Gemini 3 Pro podia ser usado

Avaliação do procedimento

• Todo o processo foi uma experiência ineficiente que levou mais de 3 horas, com uma estrutura desnecessariamente complexa para desenvolvedores individuais
• O sistema do Google é projetado com foco em conformidade regulatória para grandes organizações, o que prejudica a produtividade de usuários individuais
• Já OpenAI e Anthropic oferecem processos simples de pagamento e acesso à API, sendo mais amigáveis para desenvolvedores
• Há planos de usar o Gemini 3 Pro em caráter experimental por um mês para avaliar seu desempenho, mas a plataforma foi percebida como pouco centrada no cliente

[GN⁺]

Opiniões do Hacker News

• Tive uma experiência muito mais horrível no Microsoft Azure
  No meio do processo, uma equipe de vendas terceirizada que dizia ser “suporte oficial certificado da Microsoft” entrou em contato, e percebi que na verdade estavam tentando me vender uma opção superfaturada

• Enquanto fazia um jogo com meu filho, testei recursos de text-to-speech (TTS)
  Testei modelos do Google Gemini no navegador e funcionaram bem. Mas, ao tentar integrar via API, passei por várias tentativas e erros

  1. A Gemini API era para prototipagem e tinha uma taxa de erro de cerca de 30%, enquanto a Vertex API era estável, mas faltavam recursos. A API de TTS tinha desempenho muito ruim apesar de usar o mesmo modelo
  2. Cada API suportava parâmetros diferentes, então eu não conseguia montar a combinação que queria
  3. Tive de ler a documentação diretamente ou pedir ao Claude Code para resumir a documentação e então experimentar. Mas havia o risco de alucinações
  • O desempenho do modelo é diferente quando chamado pela API e quando usado na UI do Gemini
    A Gemini API falha aleatoriamente com cerca de 1% de probabilidade, então uma lógica de retry é essencial
    Além disso, a latência da resposta da API varia muito, de 30 segundos a 4 minutos, dependendo do estado interno do Google

• No começo do Google AdWords, qualquer pessoa com um cartão de crédito podia publicar anúncios
  Graças a essa acessibilidade imediata, a plataforma conquistava confiança e dava ao usuário comum a sensação de ser tratado no mesmo nível que uma grande empresa
  Mas, depois da aquisição da DoubleClick em 2008, acho que o foco do Google mudou dos usuários para as empresas, e a direção também mudou

  • Sempre enfatizei para as equipes de produto e vendas a importância do cadastro imediato (self-signup)
    Quero poder pagar e usar na hora, sem precisar falar com alguém nem esperar
    Mas as equipes de vendas mantêm essa estrutura porque querem discriminação de preços ou oportunidades de persuasão
  • O Google AdWords de hoje oferece uma das experiências de onboarding menos amigáveis que existem
    Cadastrar-se é fácil, mas assim que você configura o primeiro anúncio a conta é suspensa, e recorrer não adianta
    Está num nível em que só dá para usar direito contratando um especialista

• Sempre me perguntei como a UI do Cloud Console da AWS ou do GCP pode ser lançada desse jeito
  Não consigo entender como alguém pode lançar um produto desses e ainda ficar satisfeito ou ser promovido

  • Fico em dúvida se a liderança do Google já usou de fato a interface do GCP para algo além de demos
  • Tenho a sensação de que no Google não existe liderança, só acionistas
  • A estrutura complexa do console da AWS é um exemplo perfeito da Lei de Conway
    Veja a wiki da Lei de Conway e o vídeo da Molly Rocket “The Only Unbreakable Rule”

• Se você pesquisar gemini API key, aparece logo a documentação oficial
  Tem um link já no começo da documentação, e gosto do fato de ser limpa, sem design de marketing
  Talvez o problema esteja relacionado ao faturamento

  • Gerar a chave é fácil, mas o problema é o processo de pagamento e cobrança
  • Tentei várias vezes, mas o pagamento da Gemini API ainda não funciona. Mesmo falando com o Logan, nada foi resolvido
  • A maior parte das reclamações parece confundir a experiência terrível do gemini-cli com a acessibilidade geral do Gemini
  • Em produção, o ambiente real não é o AI Studio, e sim o Vertex AI
    Antes, a configuração de contas de serviço era complicada, e a documentação era focada em autenticação via CLI
    Recentemente, passou a ser possível usar API Key com o Express Mode, mas era compreensível surgirem reclamações
    No passado, a diferença de recursos entre Vertex e AI Studio também era grande
    Discussão relacionada: fórum do Google AI Studio
  • Tudo fica parcialmente quebrado várias vezes por dia
    Eu uso o AI Studio com uma conta pessoal do Workspace, e em certo momento o Gemini CLI começou a rejeitar a API key
    Sem motivo nem explicação. Estou pagando, mas o acesso foi bloqueado
    Tentei migrar para uma conta corporativa, mas a documentação era tão parecida que acabei assinando o serviço errado
    No fim, perguntei ao Gemini Pro e ele me passou um processo de 27 etapas. Se qualquer uma delas falhar, você volta ao início
    No Azure é parecido ou pior. Nem acesso ao GPT-5 eu tenho

• Cliquei no link “Set up billing” e fui do Google AI Studio para o Cloud Console
  Naquele momento, fui tomado por um sentimento de desespero. Toda vez que entro no console da AWS ou do GCP perco tempo com documentação velha e dashboards complicados

  • A situação já rende piada do tipo: “Essa documentação antiga da AWS está nesta sala agora?”

• Usei o Gemini e desisti pelo mesmo motivo
  Não tenho tempo para desperdiçar com os processos complicados do Google

• Vi “nano banana pro” e tentei pegar uma API key, mas desisti em 5 minutos
  Achei que era só comigo, mas até gente inteligente está ficando travada
  Num quiosque do McDonald’s, até quem não sabe ler consegue pedir um hambúrguer; então fico me perguntando por que o Google não consegue criar uma UX tão básica assim

  • A nuvem de IA da IBM era parecida. A documentação era antiga, e entre vários tipos de API key só uma era a verdadeira
    Era como uma fase de castelo do Mario: só dava para sair seguindo a ordem exata
    Da IBM eu até entendo, mas parece que o Google chegou nesse nível
  • Acho que isso é resultado de a cultura interna do Google estar presa numa bolha hostil ao usuário

• Se alguém da equipe da Gemini API estiver lendo, sobre o erro que ocorre ao usar Structured Outputs,
  'The specified schema produces a constraint that has too many states for serving',
  eu gostaria de pedir uma explicação mais transparente
  Provavelmente é um problema em que a gramática de restrições ou a máscara de tokens fica grande demais
  A OpenAI oferece documentação clara e limites generosos
  E uma issue relacionada também foi fechada sem explicação no GitHub
  Ainda assim, a velocidade dos modelos Gemini é impressionante, e a qualidade da API melhorou bastante em relação ao ano passado

• No passado, postei uma reclamação no HN e o Logan pediu feedback diretamente
  Ele também é bastante ativo na conta dele no X e anunciou melhorias de UX/UI para o AI Studio no próximo mês
  Mesmo dentro de uma organização enorme, dá para ver foco no produto, o que gera bastante expectativa

  • Mas anunciar no Bluesky uma “atualização de vibe coding” parece prematuro
    A direção do time não é clara, e tenho a sensação de que os PMs do Google não têm mais tanta sensibilidade de campo quanto antes
  • A equipe de relações com desenvolvedores do Google recebe feedback com frequência, mas isso raramente se transforma em ação concreta
    Parece que eles esperam até o tema se tornar estrategicamente importante
    Não entendo por que “tornar o processo de pagamento simples” não é algo estrategicamente importante