Chave de API Gemini — como obter e usar com o SDK da OpenAI

Uma chave de API Gemini é a credencial que autentica suas chamadas aos modelos Gemini do Google: toda requisição leva a chave em um cabeçalho Authorization e o uso é medido e cobrado por token. Há dois caminhos para conseguir uma chave que funcione: o Google AI Studio (oficial), que dá uma chave só para o Gemini, ou a Kunavo, onde uma única chave compatível com OpenAI alcança Gemini, Claude, GPT e modelos de imagem, vídeo e áudio — sem precisar de um projeto no Google Cloud. Este guia mostra como obter a chave pelos dois caminhos e como fazer a primeira chamada.

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

É o caminho certo se o Gemini for o único modelo que você vai chamar.

1. Entre em aistudio.google.com com uma conta Google.
2. Abra Get API key → Create API key. As chaves têm o formato AIza....
3. O nível gratuito é limitado e serve para protótipos. Para volume de produção, é preciso anexar a chave a um projeto no Google Cloud com conta de billing ativada.

Se você também usa Claude, imagem ou vídeo, esse caminho deixa você gerenciando uma chave, um SDK e uma fatura separados por fornecedor.

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

A Kunavo coloca o Gemini atrás de uma API compatível com OpenAI. Uma única chave sk-kunavo- chama o Gemini e todos os outros modelos, com uma só carteira cobrada via Stripe e sem nenhum projeto no Google Cloud. O Gemini sai cerca de 70% abaixo do preço de lista do Google — o Flash, por exemplo, custa $0.09 por 1M de tokens de entrada e $0.75 por 1M de saída. É pay-as-you-go a partir de um depósito mínimo de $5, e o saldo nunca expira.

1. Cadastre-se em kunavo.com.
2. Deposite $5 — pay-as-you-go, o saldo nunca expira.
3. Crie uma chave em /app/keys. Ela começa com sk-kunavo- e é exibida apenas uma vez; guarde-a em uma variável de ambiente.
4. Chame apontando o SDK da OpenAI para https://api.kunavo.com/v1 e usando um slug do Gemini.

Quickstart

Mantenha o SDK oficial da OpenAI. Mude 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",  # a única linha que muda
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Explique RAG em duas frases."}],
)
print(resp.choices[0].message.content)

Segurança da chave

• Nunca exponha a chave no cliente. Bundles de navegador e mobile são públicos — sempre faça o proxy pelo seu próprio servidor. Guarde a chave em variáveis de ambiente, fora do código versionado.
• Use uma chave por projeto ou ambiente, para que um vazamento possa ser revogado sem derrubar o resto.
• Faça rotação periódica. A Kunavo permite várias chaves ativas ao mesmo tempo, então a rotação é uma sobreposição limpa, e não um corte brusco.
• Defina limites de gasto por chave no dashboard e acompanhe /app/usage para flagrar tráfego inesperado, discriminado por chave.

FAQ

A API do Gemini é gratuita?

O Google AI Studio emite uma chave de nível gratuito com limites baixos, boa para protótipos; produção migra para billing pago no Google Cloud. Na Kunavo é pay-as-you-go a partir de um depósito mínimo de $5, sem conta de billing no Google Cloud, e o saldo nunca expira.

Dá para obter a chave sem conta no Google Cloud?

Sim. Na Kunavo você cria uma chave sk-kunavo- e chama o Gemini pelo endpoint compatível com OpenAI, sem abrir projeto nem ativar billing no Google Cloud.

Chave Gemini vs chave Kunavo?

Uma chave do Google chama só o Gemini e cobra por uma conta do Google Cloud. Uma chave Kunavo chama o Gemini mais Claude, GPT e modelos de imagem, vídeo e áudio por uma única API compatível com OpenAI, com uma só carteira via Stripe. Para tarifas por modelo e exemplos de custo, veja o guia de preços da API Gemini.