Cómo obtener una clave de API de Gemini: Google AI Studio frente a Kunavo

Una clave de la API de Gemini es una credencial bearer que autentica las llamadas a los modelos Gemini de Google. Hay dos formas de obtenerla: recibir una clave oficial en Google AI Studio o llamar a Gemini, Claude, GPT y modelos de imagen/vídeo con una única clave compatible con OpenAI de Kunavo, sin proyecto de Google Cloud. Esta guía compara ambas rutas y muestra la forma más rápida de empezar a hacer llamadas en producción.

Método 1 — Google AI Studio (oficial)

Si solo tienes previsto llamar a Gemini, lo adecuado es obtener la clave directamente de Google.

1. Accede a aistudio.google.com e inicia sesión con tu cuenta de Google.
2. Genera una clave mediante Get API key → Create API key. La clave tiene el formato AIza....
3. El nivel gratuito para prototipos tiene límites de solicitudes y es adecuado para el desarrollo inicial.
4. Para gestionar volúmenes de producción, debes vincular la clave a una cuenta de facturación de Google Cloud con la facturación activada.

Si Gemini seguirá siendo el único modelo al que llames, esta es la ruta adecuada. Sin embargo, si también usas Claude o modelos de imagen/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 un endpoint compatible con OpenAI. Puedes llamar a todos los modelos con una única clave sk-kn- y pagar con un único saldo de Stripe, por lo que no necesitas un proyecto de Google Cloud. Gemini cuesta aproximadamente un 70% menos que el precio oficial de Google; el saldo no caduca y pagas por uso desde una recarga mínima de $10.

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

Inicio rápido

Usa directamente el SDK oficial de OpenAI. Solo tienes que cambiar base_url y el nombre del modelo; no necesitas modificar 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",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
print(resp.choices[0].message.content)

Gestionar las claves de forma segura

• Usa variables de entorno. No incluyas la clave de forma literal en el código; guárdala en una variable de entorno como KUNAVO_API_KEY. Los paquetes de navegador y móvil son públicos, así que nunca expongas la clave al cliente y utiliza siempre un proxy mediante tu propio servidor.
• Rota las claves periódicamente. Kunavo permite varias claves activas, por lo que puedes rotarlas mediante una superposición limpia en lugar de un cambio brusco. Recomendamos hacerlo cada trimestre.
• Establece límites de gasto por clave. Define un límite de gasto para cada clave en el panel y consulta el uso por clave en /app/usage. Si una clave se filtra, podrás revocarla sin afectar a las demás.

Preguntas frecuentes