Clave API de Gemini — cómo obtenerla y usarla con el SDK de OpenAI

Una clave de API de Gemini es la credencial que autentica sus llamadas a los modelos Gemini de Google: cada solicitud incluye la clave en un encabezado Authorization, y el uso se mide y factura por token. Hay dos formas de obtener una clave funcional: Google AI Studio (oficial), que proporciona una clave exclusiva para Gemini, o Kunavo, donde una única clave compatible con OpenAI permite acceder a Gemini, Claude, GPT y modelos de imagen, vídeo y audio, sin necesidad de un proyecto de Google Cloud. Esta guía explica cómo obtener la clave mediante ambas opciones y cómo realizar la primera llamada.

Opción 1 — Google AI Studio (oficial)

Esta es la opción adecuada si Gemini es el único modelo que va a utilizar.

1. Inicie sesión en aistudio.google.com con su cuenta de Google.
2. Abra Get API key → Create API key. La clave tiene el formato AIza....
3. El nivel gratuito es limitado y adecuado para prototipos. Para volúmenes de producción, la clave debe vincularse a un proyecto de Google Cloud con una cuenta de facturación activa.

Si también utiliza Claude, imágenes o vídeo, esta opción le obliga a gestionar una clave, un SDK y una factura separados para cada proveedor.

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

Kunavo coloca Gemini detrás de una API compatible con OpenAI. Una única clave sk-kn- permite llamar a Gemini y a todos los demás modelos, con una sola cartera facturada mediante Stripe y sin ningún proyecto de Google Cloud. Gemini cuesta aproximadamente un 70% menos que el precio de lista oficial de Google; Flash, por ejemplo, cuesta $0.09 por cada millón de tokens de entrada y $0.75 por cada millón de tokens de salida. Es un modelo de pago por uso a partir de una recarga mínima de $10, y el saldo nunca caduca.

1. Regístrese en kunavo.com.
2. Recargue $10 — pago por uso; el saldo nunca caduca.
3. Cree una clave en /app/keys. Comienza por sk-kn- y solo se muestra una vez; guárdela en una variable de entorno.
4. Realice llamadas dirigiendo el SDK de OpenAI a https://api.kunavo.com/v1 y utilizando un slug de Gemini.

Inicio rápido

Mantenga el SDK oficial de OpenAI. Cambie 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",  # dòng duy nhất thay đổi
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Giải thích RAG trong hai câu."}],
)
print(resp.choices[0].message.content)

Seguridad de las claves

• No exponga nunca la clave en el lado del cliente. Los bundles para navegador y móvil son públicos; utilice siempre un proxy a través de su propio servidor. Guarde la clave en una variable de entorno, fuera del código versionado.
• Utilice una clave por proyecto o entorno, para que una filtración pueda revocarse sin dejar fuera de servicio el resto.
• Rote las claves periódicamente. Kunavo permite tener varias claves activas simultáneamente, por lo que la rotación es una transición fluida, no una interrupción repentina.
• Establezca límites de gasto por clave en el panel de control y supervise /app/usage para detectar tráfico anómalo, desglosado por clave.

Preguntas frecuentes