Como criar uma chave de API do Google Gemini

Para usar a IA da FitVitrine com o Google (escrita do conteúdo do produto e, com faturamento ativo, geração e edição de imagens), você precisa de uma chave do Gemini. O custo das operações fica na sua conta Google; a FitVitrine só faz o pedido em seu nome e não cobra nada a mais por isso.

Passo 1: Criar conta no Google AI Studio

1. Acesse aistudio.google.com.
2. Entre com uma conta Google (Gmail).
3. Aceite os termos de uso da API do Gemini.

Passo 2: Gerar a chave

1. Acesse aistudio.google.com/apikey.
2. Clique em Create API key.
3. Escolha um projeto Google Cloud existente ou deixe o Studio criar um novo para você.
4. Copie o valor gerado (começa com AQ. ou AIza).

Passo 3: Ativar faturamento (necessário só para gerar imagem)

Geração e edição de imagem exigem faturamento ativo no projeto do Google Cloud vinculado à chave. Sem faturamento, a escrita de textos continua funcionando na cota gratuita, mas a geração de imagem falha.

1. No Google Cloud Console, abra o projeto usado pela sua chave.
2. Vincule uma conta de faturamento (cartão) ao projeto.

Passo 4: Cadastrar na FitVitrine

1. No painel, abra Configurações e vá na aba Integrações.
2. No bloco Integrações com IA, abra o card Google Gemini.
3. Cole a chave no campo API Key e clique em Salvar e validar.
4. Se a chave estiver certa, o card passa a mostrar o selo de conectado e o seletor Modelo de texto, onde você escolhe qual modelo do Gemini escreve as descrições.

Se você tiver também uma chave da OpenAI cadastrada, aparece o bloco Qual IA usar, onde você define qual provedor gera as descrições de texto e qual gera as imagens.

Quanto custa

A cobrança é feita pelo Google, não pela FitVitrine. A escrita de texto costuma caber na cota gratuita diária; a geração de imagem sempre é paga e exige faturamento ativo. Os preços atuais ficam em ai.google.dev/pricing, e o que você já gastou aparece em aistudio.google.com/spend.

Dentro da FitVitrine, o gasto estimado do mês aparece em Uso e custo estimado de IA.

Em caso de erro

• Chave inválida: confira se copiou o valor inteiro. Se ainda falhar, gere uma nova em aistudio.google.com/apikey.
• Cota gratuita diária esgotada: ela volta no dia seguinte, ou ative faturamento para aumentar o limite.
• Geração de imagem falha mesmo com chave válida: confirme que o projeto do Google Cloud vinculado à chave tem faturamento ativo (passo 3).
• Muitas requisições em pouco tempo: espere um minuto e tente de novo (esse limite é por minuto, não diário).

Para usar a OpenAI em vez do Gemini, veja Como criar minha API Key da OpenAI. Para entender como a chave é guardada, veja Como protegemos sua API Key.