Crear una clave API de Google Gemini — dos vías (Google AI Studio y Kunavo)

Una clave de API de Gemini autentica tus llamadas a los modelos Gemini de Google: cada solicitud lleva la clave en el encabezado Authorization, y la plataforma mide y factura el uso a través de ella. Hay dos formas de crear una clave de API de Gemini: directamente mediante Google AI Studio (la opción oficial) o mediante Kunavo, con una clave compatible con OpenAI que permite acceder a Gemini, Claude, GPT y modelos de imagen y vídeo, sin ningún proyecto de Google Cloud.

Opción 1: crear una clave de API de Google AI Studio (oficial)

Si Gemini es el único modelo al que vas a llamar, obtén la clave directamente de Google:

1. Abre aistudio.google.com e inicia sesión con una cuenta de Google.
2. Abre Get API key → Create API key. Las claves comienzan por AIza… y solo se muestran una vez.
3. El nivel gratuito tiene límites de frecuencia y es adecuado para crear prototipos. Para producción, vincula la clave a una cuenta de facturación de Google Cloud.

Esta es la opción correcta mientras solo necesites Gemini. En cuanto también uses Claude, GPT o modelos de imagen y vídeo, tendrás que administrar una clave, un SDK y una factura independientes para cada proveedor.

Opción 2: crear una clave de API de Gemini mediante Kunavo (recomendado para producción)

Kunavo ofrece Gemini detrás de una API compatible con OpenAI. Una única clave sk-kn- permite acceder a todos los modelos mediante el mismo endpoint: no se necesita ningún proyecto de Google Cloud, Gemini cuesta aproximadamente 70% menos que la tarifa de Google ($0.09 / $0.75 por 1M de tokens), con un saldo de Stripe y pago por uso desde una recarga mínima de $10. El saldo cubre conjuntamente Gemini, Claude, GPT y los modelos de imagen y vídeo, y nunca caduca.

1. Regístrate. Crea una cuenta de Kunavo en kunavo.com.
2. Recarga $10. Pago por uso desde una recarga mínima de $10; el saldo nunca caduca.
3. Crea una clave. Genera una clave en /app/keys. Comienza por sk-kn- y solo se muestra una vez; guárdala en una variable de entorno.
4. Haz la llamada. Configura el SDK de OpenAI para que use https://api.kunavo.com/v1 y llama a un slug de Gemini.

Inicio rápido

Conserva el SDK oficial de OpenAI. Solo tienes que cambiar base_url y el nombre del modelo; 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",  # die einzige Zeile, die sich ändert
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Fasse die Handlung von Dune in zwei Sätzen zusammen."}],
)
print(resp.choices[0].message.content)

El mismo patrón se aplica a Node.js y curl; encontrarás las tarifas por modelo y ejemplos calculados en la guía de precios de la API de Gemini.

Guarda la clave de forma segura

• Usa variables de entorno en lugar del código fuente. No guardes nunca la clave en el repositorio; léela desde una variable de entorno. No la incluyas nunca en paquetes para navegador o móvil; utiliza siempre un proxy a través de tu propio servidor.
• Una clave por proyecto o entorno. Así podrás revocar una clave filtrada sin dejar todo lo demás fuera de servicio.
• Rótala con regularidad. Kunavo permite varias claves activas, por lo que la rotación ofrece una superposición ordenada en lugar de un corte brusco.
• Límites de salida por clave. Establece límites por clave en el panel de control y vigila el tráfico inesperado por clave en /app/usage.

Preguntas frecuentes