Como obter uma chave da API do Gemini — passo a passo com Google AI Studio e Kunavo

Uma chave da API Gemini é uma credencial bearer que autentica suas chamadas aos modelos Gemini do Google. Há duas maneiras de obter uma: diretamente no Google AI Studio (o caminho oficial) ou pela Kunavo — uma única chave compatível com OpenAI para Gemini, Claude, GPT e imagem/vídeo, sem configurar um projeto do Google Cloud. Este guia mostra os dois caminhos passo a passo e permite chamar o Gemini em minutos.

Opção 1 — Google AI Studio (oficial)

Se você pretende usar apenas o Gemini, pode obter uma chave diretamente do Google:

1. Faça login em aistudio.google.com com uma conta do Google.
2. Siga Get API key → Create API key. As chaves começam com AIza....
3. Há uma camada gratuita limitada, com limite de velocidade, para prototipagem.
4. Para volume de produção, você precisa vincular a chave a um projeto do Google Cloud com o faturamento ativado.

Esse é o caminho certo quando o Gemini é o único modelo que você chamará. Se você também usa modelos Claude, de imagem ou de vídeo, terá de gerenciar uma chave, um SDK e uma fatura separados por provedor.

Opção 2 — Kunavo (recomendado para produção)

A Kunavo oferece o Gemini por trás de uma API compatível com OpenAI. Uma única chave sk-kn- acessa o Gemini e todos os outros modelos (por meio de um endpoint compatível com OpenAI) — sem projeto do Google Cloud. O Gemini custa aproximadamente %70 menos que a tabela do Google, um único saldo da Stripe cobre tudo e você começa com o modelo pré-pago a partir de $10.

1. Crie uma conta da Kunavo e adicione $10 — pré-pago, sem expiração do saldo.
2. Crie uma chave na página /app/keys. A chave é exibida apenas uma vez; armazene-a em uma variável de ambiente.
3. Aponte o SDK da OpenAI para https://api.kunavo.com/v1 e chame um slug do Gemini.
4. Faça a chamada — envie o campo de modelo com um valor como gemini-2-5-flash, e pronto.

Início rápido

Você mantém o SDK oficial da OpenAI. Altere apenas base_url e o nome do modelo — nada mais:

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

Mantenha sua chave segura

• Nunca exponha a chave no lado do cliente. Navegadores e pacotes móveis são públicos — sempre faça o proxy pelo seu próprio servidor. Mantenha as chaves em arquivos .env e em variáveis de ambiente; nunca as incorpore ao código-fonte.
• Use chaves separadas por projeto ou ambiente para que um vazamento possa ser revogado sem desativar todo o restante.
• Faça a rotação regularmente. A Kunavo permite várias chaves ativas simultaneamente; assim, a rotação se torna uma transição limpa e sobreposta, em vez de uma interrupção brusca.
• Defina limites de gasto por chave. Estabeleça um limite para cada chave no painel e monitore o tráfego inesperado por chave na página /app/usage.

Perguntas frequentes