Chave de API do Gemini — como obtê-la e usá-la com o SDK da OpenAI

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

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

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

1. Abra aistudio.google.com e entre com uma conta do Google.
2. Vá para 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 velocidade e é adequado para prototipagem. Para produção, associe 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ê passará a administrar uma chave, um SDK e uma fatura por provedor.

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

A Kunavo coloca o Gemini atrás de uma API compatível com OpenAI. Uma única chave sk-kn- acessa todos os modelos pelo mesmo endpoint — nenhum projeto do Google Cloud, Gemini cerca de 70% abaixo do preço de tabela do Google ($0.09 / $0.75 por 1M de tokens), um saldo Stripe e pay-as-you-go a partir de uma recarga de $10. O saldo cobre Gemini, Claude, GPT, imagem e vídeo em conjunto e nunca expira.

1. Cadastre-se. Crie uma conta na Kunavo em kunavo.com.
2. Adicione $10. Pay-as-you-go a partir de uma recarga mínima de $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. Aponte o SDK da OpenAI para https://api.kunavo.com/v1 e chame um slug do Gemini.

Início rápido

Mantenha o SDK oficial da OpenAI. 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",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

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

Mantenha a chave segura

• Variáveis de ambiente, não código-fonte. Nunca faça commit da chave no repositório; leia-a de uma variável de ambiente. Nunca a exponha em um bundle de navegador ou celular — sempre passe pelo seu próprio servidor.
• Uma chave por projeto ou ambiente. Assim, uma chave vazada pode ser revogada sem interromper qualquer outra coisa.
• Rotação regular. A Kunavo permite várias chaves ativas, portanto a rotação é uma sobreposição tranquila, não uma interrupção abrupta.
• Limites de gastos por chave. Defina limites por chave no dashboard e monitore tráfego inesperado por chave em /app/usage.

Perguntas frequentes