Como obter uma chave da API do Gemini — Google AI Studio vs Kunavo

Uma chave da API Gemini é uma credencial Bearer que autentica chamadas aos modelos Gemini do Google. Há duas formas de obtê-la — receber uma chave oficial no Google AI Studio ou usar a Kunavo para chamar Gemini, Claude, GPT e imagem/vídeo com uma única chave compatível com OpenAI (sem projeto do Google Cloud). Este guia compara os dois caminhos e mostra a forma mais rápida de começar a fazer chamadas diretamente em produção.

Método 1 — Google AI Studio (oficial)

Se você planeja chamar apenas o Gemini, é adequado obter a chave diretamente do Google.

1. Acesse aistudio.google.com e faça login com sua conta do Google.
2. Crie a chave em Get API key → Create API key. A chave tem o formato AIza....
3. O nível gratuito para prototipagem tem limite de solicitações e é adequado ao desenvolvimento inicial.
4. Para processar volume de produção, vincule a chave a uma conta de faturamento do Google Cloud com cobrança ativada.

Se o Gemini continuar sendo o único modelo chamado, este é o caminho correto. Porém, se você também usar Claude ou modelos de imagem/vídeo, terá de gerenciar chaves, SDKs e faturas separados para cada provedor.

Método 2 — Kunavo (recomendado para produção)

A Kunavo coloca o Gemini atrás de um endpoint compatível com OpenAI. Uma única chave sk-kn- chama todos os modelos e o pagamento usa um único saldo do Stripe, portanto não é necessário um projeto do Google Cloud. O Gemini custa cerca de 70% menos que o preço de tabela do Google; o saldo não expira e a cobrança é conforme o uso a partir de uma recarga mínima de $10.

1. Cadastro — Crie uma conta em kunavo.com.
2. Adicionar $10 — Pague conforme o uso; o saldo não expira.
3. Criar chave — Crie uma chave em /app/keys. Ela começa com sk-kn- e é exibida apenas uma vez, portanto salve-a em uma variável de ambiente.
4. Chamada — Defina o base_url do SDK da OpenAI como https://api.kunavo.com/v1 e chame o slug do Gemini.

Início rápido

Use o SDK oficial da OpenAI sem alterações. Basta mudar base_url e o nome do modelo — não é necessário mudar mais nada.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
print(resp.choices[0].message.content)

Gerenciamento seguro de chaves

• Use variáveis de ambiente. Não inclua a chave diretamente no código; armazene-a em uma variável de ambiente como KUNAVO_API_KEY. Como bundles de navegador e dispositivos móveis são públicos, nunca exponha a chave no cliente e sempre faça o proxy pelo seu próprio servidor.
• Faça a rotação regularmente. A Kunavo permite várias chaves ativas, portanto você pode fazer a rotação com uma sobreposição limpa, em vez de uma troca brusca. Recomenda-se fazê-la a cada trimestre.
• Defina um limite de gastos por chave. Defina o limite de gastos de cada chave no painel e verifique o uso por chave em /app/usage. Assim, mesmo que uma chave vaze, você poderá descartá-la sem afetar as outras.

Perguntas frequentes