Como criar uma chave de API do Google Gemini — duas formas (Google AI Studio e Kunavo)

Uma chave de API do Gemini autentica suas chamadas aos modelos Gemini do Google: cada solicitação envia a chave no cabeçalho Authorization e a plataforma mede e fatura o uso por meio dela. Há duas formas de criar uma chave de API do Gemini — diretamente pelo Google AI Studio (oficial) ou pela Kunavo: uma chave compatível com OpenAI que acessa Gemini, Claude, GPT e modelos de imagem e vídeo, sem nenhum projeto do Google Cloud.

Opção 1 — Criar uma chave de API do Google AI Studio (oficial)

Se o Gemini for o único modelo que você usará, obtenha a chave diretamente do Google:

1. Acesse aistudio.google.com e faça login com uma conta do Google.
2. Abra Get API key → Create API key. As chaves começam com AIza… e são exibidas apenas uma vez.
3. O nível gratuito tem limite de taxa e é adequado para prototipagem. Para produção, vincule a chave a uma conta de faturamento do Google Cloud.

Esse é o caminho certo enquanto você precisar apenas do Gemini. Assim que também usar Claude, GPT ou modelos de imagem e vídeo, você administrará uma chave, um SDK e uma fatura próprios para cada provedor.

Opção 2 — Criar uma chave de API do Gemini pela Kunavo (recomendado para produção)

A Kunavo disponibiliza o Gemini por uma API compatível com OpenAI. Uma única chave sk-kn- acessa todos os modelos pelo mesmo endpoint — nenhum projeto do Google Cloud é necessário, Gemini cerca de 70% abaixo da tabela do Google ($0.09 / $0.75 por 1 milhão de tokens), um saldo do Stripe e pagamento conforme o uso a partir de uma recarga mínima de US$ 10. O saldo cobre Gemini, Claude, GPT e imagem e vídeo em conjunto e nunca expira.

1. Cadastre-se. Crie uma conta da Kunavo em kunavo.com.
2. Adicione US$ 10. Pagamento conforme o uso a partir de uma recarga mínima de US$ 10; o saldo nunca expira.
3. Crie a chave. Gere uma chave em /app/keys. Ela começa com sk-kn- e é exibida apenas uma vez — armazene-a em uma variável de ambiente.
4. Faça a chamada. Configure o OpenAI SDK para https://api.kunavo.com/v1 e chame um slug do Gemini.

Início rápido

Mantenha o OpenAI SDK oficial. Você só altera base_url e o nome do modelo — nada mais.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # die einzige Zeile, die sich ändert
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Fasse die Handlung von Dune in zwei Sätzen zusammen."}],
)
print(resp.choices[0].message.content)

O mesmo padrão vale para Node.js e curl; as tarifas por modelo e os exemplos calculados estão no guia de preços da API do Gemini.

Armazene a chave com segurança

• Use variáveis de ambiente em vez do código-fonte. Nunca coloque a chave no repositório; leia-a de uma variável de ambiente. Nunca a envie para bundles de navegador ou dispositivos móveis — sempre faça o proxy pelo seu próprio servidor.
• Uma chave por projeto ou ambiente. Assim, é possível revogar uma chave vazada sem derrubar todo o restante.
• Faça a rotação regularmente. A Kunavo permite várias chaves ativas, de modo que a rotação seja uma sobreposição controlada, e não uma interrupção brusca.
• Limites de saída por chave. Defina limites por chave no painel e monitore o tráfego inesperado por chave em /app/usage.

Perguntas frequentes