Clave de API de Gemini

Una clave de API de Gemini autentica sus llamadas a los modelos Gemini de Google. Puede obtener una directamente desde Google AI Studio o usar una sola clave de sk-kn- que accede a Gemini mediante la misma API compatible con OpenAI que ya utiliza para todo lo demás.

Qué es una clave de API de Gemini

Una clave de API de Gemini es una credencial bearer que autoriza las solicitudes a la familia Gemini de Google. Cada solicitud incluye la clave en un encabezado Authorization; la plataforma mide el uso asociado a ella y factura por token. Actualmente, en Kunavo, esto permite usar gemini-3-1-pro y gemini-2-5-flash a través del endpoint compatible con OpenAI.

Hay dos formas de obtener una clave válida, según quiera usar solo Gemini o Gemini junto con otros modelos de vanguardia.

Opción A: una clave directamente de Google AI Studio

1. Vaya a aistudio.google.com e inicie sesión con una cuenta de Google.
2. Abra Get API key → Create API key. Las claves tienen el formato AIza....
3. Para un volumen de producción, asocie la clave a un proyecto de Google Cloud con la facturación habilitada.

Esta es la opción adecuada si solo va a llamar a Gemini. Si también utiliza Claude o modelos de imagen o vídeo, tendría que gestionar una clave, un SDK y una factura distintos para cada proveedor.

Opción B: una clave de Kunavo para Gemini y todo lo demás

Kunavo es una pasarela de API de IA independiente y compatible con OpenAI: una clave de API y un saldo de pago por uso permiten acceder a Claude, GPT y modelos de imagen, vídeo y audio, sin necesidad de una cuenta por proveedor.

Kunavo ofrece Gemini a través de una API compatible con OpenAI. Una sola clave sk-kn- permite acceder a Gemini y a todos los demás modelos, con un único saldo facturado por Stripe.

1. Cree una cuenta de Kunavo y añada una recarga de $10: pague por uso y su saldo nunca caducará.
2. Genere una clave en /app/keys. Se muestra una sola vez; guárdela en una variable de entorno.
3. Configure el SDK de OpenAI para usar https://api.kunavo.com/v1 y llame a un slug de Gemini.

Llamar a Gemini con Python

Siga usando el SDK oficial de OpenAI. Cambie base_url y el nombre del modelo; no hace falta nada más.

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)

Llamar a Gemini con 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);

O llámelo con 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"}]
  }'

Qué modelo de Gemini usar

• gemini-2-5-flash: opción predeterminada rápida y extremadamente económica para chats, extracción y resúmenes.
• gemini-3-1-pro: mejores capacidades de razonamiento, visión y análisis de contextos largos.

Lista de seguridad

• Nunca exponga una clave en el lado del cliente. Los paquetes para navegadores y móviles son públicos: canalice siempre las solicitudes a través de su propio servidor.
• Use una clave por proyecto o entorno para que una filtración se pueda revocar sin interrumpir todo lo demás.
• Rote las claves trimestralmente. Kunavo permite tener varias claves activas, por lo que la rotación se realiza con un solapamiento ordenado, sin un cambio brusco.
• Supervise /app/usage para detectar tráfico inesperado desglosado por clave.

Preguntas frecuentes

Próximos pasos

• Inicio rápido: tu primera solicitud en 60 segundos
• Precios de la API de Gemini en 2026
• Consulte el catálogo completo de modelos