Como conectar sua chave de API do Google Gemini ao QKeyboard

O Google Gemini é uma das opções mais acessíveis para BYOK, principalmente porque o Google AI Studio oferece um nível gratuito de uso da API. Isso faz dele um bom ponto de partida se você quer testar a conexão da sua própria chave ao QKeyboard antes de optar por um provedor pago.

Passo 1: obtenha uma chave no Google AI Studio

1. Acesse o Google AI Studio e faça login com sua conta do Google.
2. Abra a seção de chaves de API.
3. Crie uma nova chave de API, em um projeto novo ou existente.
4. Copie a chave assim que ela for gerada.

Ao contrário de alguns outros provedores, o Google AI Studio normalmente permite gerar uma chave funcional sem adicionar uma forma de pagamento primeiro, já que o uso dentro do nível gratuito não exige que a cobrança esteja ativada.

Por que o nível gratuito importa para BYOK

Um motivo relevante para algumas pessoas escolherem Gemini para BYOK é que reescritas leves do dia a dia muitas vezes podem ficar dentro da cota gratuita de uso do Google. Isso significa que você aproveita os benefícios do BYOK — sua chave, sua conta e solicitações enviadas diretamente ao seu provedor — sem necessariamente pagar nada a mais, desde que o uso fique dentro dos limites do nível gratuito. Um uso mais intenso acabará exigindo a ativação da cobrança, então vale conferir os termos atuais do nível gratuito do Google se você escreve muito.

Passo 2: conecte a chave ao QKeyboard

1. Abra os Ajustes do QKeyboard pelo app ou pelo menu do teclado.
2. Vá para a seção Provedor de IA / BYOK.
3. Selecione Google Gemini na lista de provedores.
4. Cole a chave de API que você copiou do AI Studio.
5. Selecione um modelo.
6. Salve.

Como acontece com qualquer provedor BYOK, a chave fica armazenada nas Chaves da Apple, não nos servidores do QKeyboard, e é usada apenas para enviar suas solicitações de reescrita diretamente ao Google.

Limites diários com BYOK

A IA integrada do QKeyboard limita as reescritas a 20 por dia no plano gratuito. Conectar uma chave do Gemini aumenta esse limite para 100 reescritas por dia no plano gratuito. O QKeyboard Pro remove completamente o limite diário, com ou sem BYOK.

Mesmo no nível gratuito, o uso está sujeito aos próprios limites e termos do Google, independentemente do que o QKeyboard controla.

Problemas comuns

• Se as solicitações falharem, confirme se a chave foi gerada para o projeto correto do Google Cloud e se a API do Gemini está ativada nele.
• Se você atingir o limite do nível gratuito, pode esperar que ele seja redefinido ou adicionar a cobrança à sua conta do Google para continuar usando o serviço.
• Você pode voltar à IA integrada do QKeyboard a qualquer momento na mesma tela de ajustes.