Cómo obtener una clave de API de Gemini — dos métodos: Google AI Studio y Kunavo

Una clave de la API de Gemini es una credencial de tipo bearer que autentica las llamadas a los modelos Gemini de Google. Hay dos formas de obtenerla: Google AI Studio (la opción oficial) o una única clave compatible con OpenAI de Kunavo para llamar a Gemini, Claude, GPT y modelos de imagen/vídeo sin un proyecto de Google Cloud. Esta guía explica ambos procedimientos y cuál elegir en producción.

Método 1 — Google AI Studio (oficial)

Si solo vas a usar Gemini, obtener la clave directamente de Google es la opción habitual.

1. Inicia sesión en aistudio.google.com con tu cuenta de Google.
2. Abre Obtener clave de API → Crear clave de API. La clave tiene un formato como AIza....
3. Para crear prototipos puedes usar el nivel gratuito con límites de velocidad. Para cargas de producción, debes vincular la clave a un proyecto de Google Cloud con la facturación habilitada.

Si solo vas a llamar a modelos Gemini, esta es la ruta adecuada. Sin embargo, si también usas Claude o modelos de imagen y vídeo, tendrás que gestionar claves, SDK y facturas independientes para cada proveedor.

Método 2 — Kunavo (recomendado para producción)

Kunavo coloca Gemini detrás de una API compatible con OpenAI. Con una única clave sk-kn- puedes acceder a Gemini y a todos los demás modelos; no necesitas un proyecto de Google Cloud y el pago se concentra en un único saldo de Stripe. Gemini cuesta aproximadamente un 70% menos que el precio oficial de Google y el pago por uso comienza en $10.

1. Regístrate — crea una cuenta en kunavo.com.
2. Recarga $10 — pago por uso; el saldo no caduca.
3. Crea una clave — crea una clave en /app/keys. Comienza por sk-kn- y solo se muestra una vez, así que guárdala en una variable de entorno.
4. Haz una llamada — dirige base_url del SDK de OpenAI a https://api.kunavo.com/v1 y especifica el slug de Gemini.

También puedes consultar la tabla comparativa de la documentación de la clave de la API de Gemini. Para el desglose de precios, consulta la guía de precios de la API de Gemini.

Inicio rápido

Usa directamente el SDK oficial de OpenAI. Solo tienes que cambiar base_url y el nombre del 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)

Gestión segura de claves

• Usa variables de entorno. No escribas la clave directamente en el código; cárgala desde una variable de entorno como KUNAVO_API_KEY. Los paquetes de navegador y móvil son públicos, así que no expongas la clave en el cliente y utiliza siempre un proxy a través de tu propio servidor.
• Rota las claves periódicamente. Kunavo permite tener varias claves activas a la vez, por lo que la rotación puede hacerse mediante una superposición limpia, no mediante un cambio brusco. Se recomienda hacerlo trimestralmente.
• Establece límites por clave. Define un límite para cada clave en el panel y separa las claves por proyecto o entorno. Si una clave se filtra, podrás revocar solo esa clave sin detenerlo todo. Supervisa el tráfico por clave en /app/usage.

Preguntas frecuentes