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

Una clave de la API de Gemini es una credencial bearer que autentica tus llamadas a los modelos Gemini de Google. Hay dos formas de obtenerla: directamente desde Google AI Studio (la opción oficial) o mediante Kunavo: una única clave compatible con OpenAI para Gemini, Claude, GPT e imagen/vídeo, sin configurar un proyecto de Google Cloud. Esta guía muestra ambos métodos paso a paso y te permite llamar a Gemini en cuestión de minutos.

Opción 1 — Google AI Studio (oficial)

Si solo vas a utilizar Gemini, puedes obtener una clave directamente de Google:

1. Inicia sesión en aistudio.google.com con una cuenta de Google.
2. Sigue Get API key → Create API key. Las claves comienzan por AIza....
3. Hay un nivel gratuito limitado y sujeto a límites de velocidad para la creación de prototipos.
4. Para volúmenes de producción, debes vincular la clave a un proyecto de Google Cloud con la facturación habilitada.

Esta es la opción adecuada cuando Gemini es el único modelo que vas a utilizar. Si también utilizas modelos Claude, de imagen o de vídeo, tendrás que gestionar una clave, un SDK y una factura separados por proveedor.

Opción 2 — Kunavo (recomendada para producción)

Kunavo ofrece Gemini detrás de una API compatible con OpenAI. Una única clave sk-kn- permite acceder a Gemini y a todos los demás modelos (a través de un endpoint compatible con OpenAI), sin proyecto de Google Cloud. Gemini tiene un precio aproximadamente un %70 inferior al de la lista de Google, un único saldo de Stripe cubre todo y empiezas con un modelo de pago por uso desde $10.

1. Crea una cuenta de Kunavo y añade $10: pago por uso y el saldo nunca caduca.
2. Crea una clave en la página /app/keys. La clave solo se muestra una vez; guárdala en una variable de entorno.
3. Apunta el SDK de OpenAI a https://api.kunavo.com/v1 y llama a un slug de Gemini.
4. Haz la llamada: envía el campo del modelo con un valor como gemini-2-5-flash y listo.

Inicio rápido

Conservas el SDK oficial de OpenAI. Cambia únicamente base_url y el nombre del modelo; nada más:

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

Mantén tu clave segura

• No expongas nunca la clave en el lado del cliente. Los paquetes para navegador y móvil son públicos; utiliza siempre un proxy en tu propio servidor. Guarda las claves en archivos .env y variables de entorno, nunca incrustadas en el código fuente.
• Utiliza una clave distinta por proyecto o entorno para poder revocarla si se filtra sin desactivar todo lo demás.
• Rota las claves periódicamente. Kunavo permite varias claves activas simultáneamente, de modo que la rotación sea una transición limpia y solapada en lugar de una interrupción brusca.
• Establece límites de gasto por clave. Define un límite para cada clave desde el panel y supervisa el tráfico inesperado por clave en la página /app/usage.

Preguntas frecuentes