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

Uma chave da API do Gemini é uma credencial que autentica suas chamadas aos modelos Gemini do Google: cada solicitação envia a chave no cabeçalho Authorization, e o uso é medido e cobrado por token. Há dois caminhos para obter uma chave funcional: o Google AI Studio (oficial), que fornece uma chave exclusiva do Gemini, ou a Kunavo, na qual uma única chave compatível com a OpenAI dá acesso a Gemini, Claude, GPT e modelos de imagem, vídeo e áudio — sem precisar de um projeto do Google Cloud. Este guia mostra como obter uma chave pelos dois caminhos e como fazer sua primeira chamada.

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

Este é o caminho certo se o Gemini for o único modelo que você pretende chamar.

1. Faça login no aistudio.google.com com sua conta do Google.
2. Abra Get API key → Create API key. A chave tem o formato AIza....
3. O nível gratuito é limitado e adequado para protótipos. Para volumes de produção, a chave precisa ser vinculada a um projeto do Google Cloud com uma conta de faturamento ativa.

Se você também usar Claude, imagens ou vídeo, esse caminho exige o gerenciamento de uma chave, um SDK e uma cobrança separados para cada provedor.

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

A Kunavo disponibiliza o Gemini por trás de uma API compatível com a OpenAI. Uma única chave sk-kn- chama o Gemini e todos os outros modelos, com uma única carteira cobrada via Stripe e sem qualquer projeto do Google Cloud. O Gemini custa cerca de 70% menos que os preços oficiais de tabela do Google — o Flash, por exemplo, custa $0.09 por 1 milhão de tokens de entrada e $0.75 por 1 milhão de tokens de saída. É um modelo pré-pago conforme o uso, a partir de uma recarga mínima de $10, e o saldo nunca expira.

1. Cadastre-se em kunavo.com.
2. Recarregue $10 — pré-pago conforme o uso; o saldo nunca expira.
3. Crie uma chave em /app/keys. A chave começa com sk-kn- e só é exibida uma vez; armazene-a em uma variável de ambiente.
4. Faça uma chamada apontando o SDK da OpenAI para https://api.kunavo.com/v1 e usando um slug do Gemini.

Início rápido

Continue usando o SDK oficial da OpenAI. Altere 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",  # dòng duy nhất thay đổi
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Giải thích RAG trong hai câu."}],
)
print(resp.choices[0].message.content)

Segurança da chave

• Nunca exponha a chave no lado do cliente. Bundles de navegador e dispositivos móveis são públicos — sempre faça o proxy pelo seu próprio servidor. Armazene a chave em uma variável de ambiente, fora do código versionado.
• Use uma chave por projeto ou ambiente, para que um vazamento possa ser revogado sem derrubar os demais.
• Faça a rotação regularmente. A Kunavo permite várias chaves ativas ao mesmo tempo, portanto a rotação é uma transição suave, não uma interrupção repentina.
• Defina um limite de gastos por chave no dashboard e monitore /app/usage para identificar tráfego inesperado, discriminado por chave.

Perguntas frequentes