Usa tu clave de API de Gemini en una app, sin código

En qué se diferencia la API de Gemini de la app de Gemini

Google ofrece Gemini de dos maneras. La app de Gemini, con su plan gratuito y sus planes de pago de Google AI, es un producto de consumo. La API de Gemini es un producto de desarrolladores: creas una clave de API, y el software —incluida una app de chat que acepta tu propia clave— envía solicitudes a los modelos de Gemini en tu nombre.

La API se gestiona en Google AI Studio y se apoya en un proyecto de Google Cloud. La documentación de Google indica que cada clave de API de Gemini está asociada a un proyecto de Google Cloud, y que el proyecto es donde se gestionan la facturación, los colaboradores y los permisos. Los límites de frecuencia aplican por proyecto, no por clave. El uso de pago de la API se activa vinculando una cuenta de facturación de Cloud a ese proyecto, así que no des por hecho que un plan de Google AI de consumo paga las solicitudes de la API.

Paso 1: crea una clave de API de Gemini

Crear una clave toma un minuto y no requiere tarjeta de crédito para el nivel gratuito. Si eres nuevo en AI Studio, este crea un proyecto de Google Cloud por defecto y una clave de API por ti después de que aceptes los términos del servicio.

• Ve a aistudio.google.com/apikey e inicia sesión con tu cuenta de Google.
• Acepta los términos del servicio si los pide; los usuarios nuevos reciben un proyecto por defecto y una clave automáticamente.
• Crea una clave de API, o copia la que ya se creó, y fíjate a qué proyecto pertenece.
• Guarda la clave en un lugar seguro, como un administrador de contraseñas. Las claves de Gemini suelen empezar con «AIza».

Paso 2: decide entre el nivel gratuito y el de pago

Esta es la decisión que más importa con Gemini, porque los dos niveles se diferencian en más que el precio. La página de precios lista, para cada modelo, si el nivel gratuito es «Free of charge» o «Not available», y también dice cómo se trata tu contenido en cada nivel.

En el nivel gratuito, la página de precios de Google dice que el contenido se usa para mejorar sus productos; en el de pago, dice que no se usa para mejorarlos. Si piensas pegar algo personal o confidencial, esa diferencia es una razón para vincular la facturación aunque tu uso quepa dentro de los límites gratuitos.

Los límites de frecuencia también difieren. Un proyecto sin facturación está en el nivel gratuito. Vincular una cuenta de facturación activa lo pasa al Tier 1, y los niveles más altos llegan con el gasto acumulado en el tiempo. Los límites varían por modelo, y Google señala que se muestran en AI Studio y se actualizan solos cuando cambia tu nivel.

Cuánto cuesta Gemini en el nivel de pago

La tabla muestra los precios de pago publicados de Google para tres modelos actuales a 28 de septiembre de 2026, para prompts de hasta 200,000 tokens, con un costo estimado para un mensaje de chat típico de 2,000 tokens de entrada y 600 de salida. Fíjate en el precio con fecha de Gemini 3.8 Flash: Google lista $0.75 de entrada y $3.75 de salida hasta el 31 de diciembre de 2026, y $1.50 de entrada y $7.50 de salida a partir del 1 de enero de 2027.

Para Gemini 3.8 Flash la aritmética es 2,000 × $0.75 / 1,000,000 + 600 × $3.75 / 1,000,000 = $0.00375: menos de medio centavo. Los hilos largos cuestan más por mensaje porque los turnos anteriores se reenvían como entrada, y la factura de Google es el monto final.

Paso 3: agrega la clave en Oriveo

Oriveo es una app de chat de IA multimodelo para iPhone, Android y la web que funciona con tus propias claves. Google Gemini es uno de sus 15 proveedores oficiales, bajo Direct AI Providers. Las etiquetas de abajo son las que muestra la app en inglés.

Al continuar, Oriveo verifica la clave preguntándole a Google por los modelos a los que puede acceder, y luego sincroniza esa lista. Una clave que Google rechaza se reporta de inmediato, para que la corrijas antes de chatear.

Paso 4: elige un modelo y chatea

Una vez conectado, los modelos de Gemini aparecen en el selector de modelos. Los Flash son rápidos y baratos y cubren la mayoría del chat del día a día; los Pro son para razonamiento más difícil y análisis más largos. Si tu clave está en el nivel gratuito, quédate con los modelos que la página de precios marca como gratis, porque los modelos solo de pago devolverán un error sin facturación.

Puedes cambiarte a otro modelo a mitad de la conversación, incluido uno de otro proveedor que hayas conectado, y seguir en el mismo hilo. Cada mensaje muestra un costo estimado al precio publicado de Google; en el nivel gratuito, recuerda que el cargo real por los modelos gratis es cero y el límite que muerde es el de frecuencia.

Errores comunes y qué significan

Los errores de Gemini suelen ser lo bastante específicos para apuntar a la causa.

• «API key not valid»: la clave se copió incompleta, fue borrada o está restringida. Cópiala de nuevo desde AI Studio o crea una nueva.
• Límite de frecuencia o recursos agotados: alcanzaste el límite por minuto o por día de tu proyecto para ese modelo. Espera, cámbiate de modelo, o vincula la facturación para límites más altos.
• Modelo no disponible en tu nivel: algunos modelos son solo de pago. Vincula la facturación al proyecto o elige un modelo gratis.
• Varias claves topándose con los límites a la vez: los límites son por proyecto, así que las claves del mismo proyecto los comparten.

Cuida tu clave

Una clave de Gemini puede gastar dinero una vez vinculada la facturación, y aun antes puede agotar tu cuota gratuita. Oriveo mantiene las claves de los proveedores en tu dispositivo o en tu navegador, no como registros de cuenta. Las apps de iPhone y Android envían las solicitudes a Google directamente; la app web usa un endpoint de reenvío en tiempo real que no retiene la clave ni el contenido del chat BYOK. Oriveo no agrega recargo a los precios de Google.

Usa un proyecto o una clave dedicados para tu app de chat, revisa el uso en AI Studio y en la consola de Cloud, y elimina cualquier clave que haya quedado expuesta.