Chave de API do Gemini

Uma chave de API do Gemini autentica suas chamadas aos modelos Gemini do Google. Você pode obter uma diretamente no Google AI Studio ou usar uma única chave sk-kn- que dá acesso ao Gemini pela mesma API compatível com a OpenAI que você já usa para todo o restante.

O que é uma chave de API do Gemini

Uma chave de API do Gemini é uma credencial bearer que autoriza solicitações à família Gemini do Google. Cada solicitação inclui a chave em um cabeçalho Authorization; a plataforma mede o uso com base nela e cobra por token. Atualmente, na Kunavo, isso inclui gemini-3-1-pro e gemini-2-5-flash, acessados pelo endpoint compatível com a OpenAI.

Há duas maneiras de obter uma chave funcional, dependendo de você querer usar apenas o Gemini ou o Gemini junto com outros modelos de ponta.

Opção A — uma chave diretamente do Google AI Studio

1. Acesse aistudio.google.com e entre com uma conta do Google.
2. Abra Get API key → Create API key. As chaves têm o formato AIza....
3. Para uso em produção, associe a chave a um projeto do Google Cloud com faturamento ativado.

Esse é o caminho indicado se o Gemini for o único modelo que você usará. Se também usar Claude ou modelos de imagem e vídeo, terá de gerenciar uma chave, um SDK e uma fatura separados para cada provedor.

Opção B — uma chave da Kunavo para Gemini e todo o restante

A Kunavo é um gateway independente de API de IA compatível com a OpenAI: uma única chave de API e um saldo pré-pago permitem acessar Claude, GPT e modelos de imagem, vídeo e áudio, sem exigir uma conta em cada provedor.

A Kunavo oferece o Gemini por meio de uma API compatível com a OpenAI. Uma única chave sk-kn- dá acesso ao Gemini e a todos os outros modelos, com um saldo único cobrado pelo Stripe.

1. Crie uma conta da Kunavo e adicione uma recarga de $10 — pague conforme o uso, e o saldo nunca expira.
2. Gere uma chave em /app/keys. Ela é exibida uma única vez; guarde-a em uma variável de ambiente.
3. Configure o SDK da OpenAI para usar https://api.kunavo.com/v1 e chame um slug do Gemini.

Chame o Gemini com Python

Mantenha 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",  # the only line that changes
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Summarize the plot of Dune in two sentences."}],
)
print(resp.choices[0].message.content)

Chame o Gemini com Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gemini-2-5-flash",
  messages: [{ role: "user", content: "Summarize the plot of Dune in two sentences." }],
});
console.log(resp.choices[0].message.content);

Ou faça a chamada com curl

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2-5-flash",
    "messages": [{"role": "user", "content": "Hello, Gemini"}]
  }'

Qual modelo Gemini usar

• gemini-2-5-flash — opção padrão rápida e extremamente barata para conversas, extração e resumo.
• gemini-3-1-pro — raciocínio mais avançado, visão e análise de contexto longo.

Lista de verificação de segurança

• Nunca exponha uma chave no lado do cliente. Pacotes de navegador e aplicativos móveis são públicos — sempre encaminhe as chamadas pelo seu próprio servidor.
• Use uma chave por projeto ou ambiente para que, em caso de vazamento, você possa revogá-la sem interromper todo o restante.
• Faça a rotação trimestralmente. A Kunavo permite várias chaves ativas, então a rotação pode ser feita com uma sobreposição simples, sem uma troca abrupta.
• Acompanhe /app/usage para identificar tráfego inesperado por chave.

Perguntas frequentes

Próximos passos

• Início rápido — sua primeira solicitação em 60 segundos
• Preços da API do Gemini em 2026
• Explore o catálogo completo de modelos