Como obter uma chave de API do Gemini — dois métodos: Google AI Studio e Kunavo

Uma chave da API Gemini é uma credencial de autenticação Bearer para chamadas aos modelos Gemini do Google. Há duas formas de obtê-la — pelo Google AI Studio (oficial) ou usando uma única chave compatível com OpenAI da Kunavo para chamar Gemini, Claude, GPT e modelos de imagem/vídeo (sem projeto do Google Cloud). Este guia explica os dois procedimentos e qual escolher em produção.

Método 1 — Google AI Studio (oficial)

Se você usa apenas o Gemini, obter a chave diretamente do Google é o caminho tradicional.

1. Faça login em aistudio.google.com com sua conta do Google.
2. Abra Obter chave de API → Criar chave de API. A chave tem um formato como AIza....
3. Para protótipos, há um nível gratuito com limite de taxa. Para volume de produção, é necessário vincular a chave a um projeto do Google Cloud com faturamento ativado.

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

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

A Kunavo disponibiliza o Gemini por trás de uma API compatível com OpenAI. Com uma única chave sk-kn- você alcança Gemini e todos os outros modelos, sem projeto do Google Cloud, e os pagamentos ficam reunidos em um único saldo do Stripe. O Gemini custa cerca de 70% menos que o preço de tabela do Google, e você pode começar com cobrança conforme o uso a partir de $10.

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

Você também pode confirmar qual método é melhor na tabela comparativa da documentação da chave da API Gemini. Para o detalhamento dos preços, consulte o guia de preços da API Gemini.

Início rápido

Use o SDK oficial da OpenAI sem alterações. Basta mudar base_url e o nome do modelo.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 変更するのはこの 1 行だけ
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",  # Gemini モデルのスラッグを指定
    messages=[{"role": "user", "content": "Gemini を一文で説明して。"}],
)
print(resp.choices[0].message.content)

Gerenciamento seguro de chaves

• Use variáveis de ambiente. Não escreva a chave diretamente no código; carregue-a de 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 simultaneamente, portanto a rotação pode ocorrer com uma sobreposição limpa, sem uma troca brusca. A recomendação é fazê-la a cada trimestre.
• Defina limites por chave. Configure um limite para cada chave no painel e separe as chaves por projeto ou ambiente. Assim, mesmo em caso de vazamento, você pode revogar apenas aquela chave sem interromper tudo. Monitore o tráfego por chave em /app/usage.

Perguntas frequentes