Cómo Usar la API de Gemini 3.0

Los desarrolladores buscan constantemente modelos de IA potentes sin incurrir en altos costos. Google aborda esta necesidad ofreciendo acceso gratuito a modelos avanzados, incluidas versiones preliminares como Gemini 3 Pro.

💡

Antes de continuar, descarga Apidog gratis ahora mismo – sirve como un excelente cliente API para enviar solicitudes a la API de Gemini 3, inspeccionar respuestas, manejar entradas multimodales y depurar endpoints de manera eficiente durante tus experimentos de nivel gratuito.

botón

Google mantiene un generoso nivel gratuito para la API de Gemini a través de Google AI Studio. Esta configuración te permite generar una clave API y comenzar a llamar a los modelos de inmediato. Además, a partir de noviembre de 2025, Google proporciona acceso a modelos de vista previa de Gemini 3 Pro sin cargo, aunque con límites de velocidad adecuados para prototipos, pruebas y aplicaciones a pequeña escala.

Entendiendo los Precios de la API de Gemini 3

En términos generales, los precios de Gemini 3.0 son los siguientes:

<200k tokens $2.00 de entrada, $12.00 de salida
>200k tokens $4.00 de entrada, $18.00 de salida

La fecha límite de conocimiento de Gemini 3.0 está fijada en enero de 2025.

Si quieres usar la API de Gemini 3.0 gratis, Google es lo suficientemente generoso como para permitirte probarla: Google estructura la API de Gemini en dos niveles principales: gratuito y de pago por uso. El nivel gratuito funciona completamente sin activación de facturación. En consecuencia, todas las solicitudes siguen siendo gratuitas hasta que habilites explícitamente la Facturación de Cloud para cuotas más altas.

Google AI Studio funciona como la interfaz principal para el acceso gratuito. Aquí, creas prototipos de prompts, generas claves API y llamas a modelos directamente. Los modelos de vista previa como Gemini 3 Pro aparecen automáticamente en el selector de modelos cuando están disponibles en tu región.

Las ventajas clave del nivel gratuito incluyen:

No se requiere tarjeta de crédito
Acceso a modelos de vista previa de vanguardia, incluido Gemini 3 Pro
Soporte para entradas multimodales (texto, imágenes, video, audio)
Llamada a funciones, salidas estructuradas y herramientas de ejecución de código
Límites de velocidad que se restablecen diariamente, suficientes para el desarrollo y un uso de producción moderado

Sin embargo, el nivel gratuito impone cuotas para garantizar un uso justo. Los límites típicos para los modelos de vista previa de Gemini 3 Pro son de aproximadamente 5-10 solicitudes por minuto (RPM), 250,000 tokens por minuto (TPM) y 50-100 solicitudes por día (RPD). Estos valores varían según la variante del modelo y la región, y Google los ajusta periódicamente.

Paso a Paso: Genera tu Clave API de Gemini 3

Comienzas creando una clave API en Google AI Studio. Sigue estos pasos precisos:

Navega a aistudio.google.com.
Inicia sesión con tu cuenta de Google (personal o de Workspace).

4. Haz clic en el icono de perfil en la esquina superior derecha y selecciona "Obtener clave API". Elige "Crear clave API en un nuevo proyecto" (o selecciona uno existente).

6. Google genera la clave al instante. Cópiala inmediatamente; no podrás verla de nuevo.

Además, puedes crear varias claves y restringirlas a remitentes o direcciones IP específicos para mayor seguridad. Siempre trata la clave como datos sensibles; nunca la publiques en repositorios públicos.

Para acceso directo a la vista previa de Gemini 3 Pro, visita este enlace proporcionado por Google: https://aistudio.google.com/prompts/new_chat?model=gemini-3-pro-preview. Esto abre una interfaz de chat preconfigurada con el modelo de vista previa.

Probemos la API de Gemini 3.0 en Google AI Studio

Instalando los SDKs Oficiales de Gemini para Acceso Programático

Google proporciona bibliotecas cliente en varios lenguajes. Se instalan a través de gestores de paquetes.

Para desarrolladores de Python:

pip install -U google-generativeai

Luego configura la biblioteca:

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY_HERE")

model = genai.GenerativeModel("gemini-3-pro-preview-11-2025")
response = model.generate_content("Explain quantum entanglement in simple terms.")
print(response.text)

Los usuarios de Node.js ejecutan:

npm install @google/generative-ai

const { GoogleGenerativeAI } = require("@google/generative-ai");

const genAI = new GoogleGenerativeAI("YOUR_API_KEY_HERE");
const model = genAI.getGenerativeModel({ model: "gemini-3-pro-preview-11-2025" });

const result = await model.generateContent("Write a Python function to calculate Fibonacci numbers.");
console.log(result.response.text());

Otros lenguajes compatibles incluyen Go, Java y Swift. Todas las bibliotecas manejan la autenticación, los reintentos y el streaming automáticamente.

Enviando tu Primera Solicitud a la API de Gemini 3 Usando curl

Puedes probar directamente con curl para una verificación rápida:

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-preview-11-2025:generateContent?key=YOUR_API_KEY \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "Describe the key improvements in Gemini 3 over previous versions." }]
    }]
  }'

Este endpoint devuelve una respuesta JSON que contiene el texto generado y metadatos de uso.

Usa Apidog para un Flujo de Trabajo de Prueba de API Mejor y Más Integrado

Los comandos curl básicos funcionan para pruebas simples, pero el desarrollo de grado de producción exige mejores herramientas. Apidog destaca aquí como un cliente API y una plataforma de documentación con todas las funciones.

botón

Importa la especificación OpenAPI oficial de Gemini en Apidog, que genera automáticamente todos los endpoints, parámetros y cuerpos de solicitud. Posteriormente, puedes:

Guardar tu clave API como una variable de entorno
Crear colecciones para diferentes casos de uso (generación de texto, visión, llamada a funciones)
Enviar solicitudes multimodales cargando imágenes o videos directamente
Ver el uso de tokens y los metadatos de respuesta en tiempo real
Generar código cliente (Python, JS, etc.) a partir de solicitudes reales
Simular servidores para pruebas frontend sin consumir cuota

La interfaz de Apidog para probar los endpoints de la API de Gemini 3

Muchos desarrolladores eligen Apidog específicamente para flujos de trabajo de Gemini porque maneja sin problemas cargas de archivos grandes, respuestas de streaming y salidas JSON estructuradas, características con las que Postman tiene dificultades para las APIs generativas.

¿Cuáles son los Límites de Tasa de la API de Gemini 3.0?

Google no revela actualmente el límite de tasa de la API de Gemini 3.0, aunque los usuarios informan que están sufriendo límites de tasa con solo unas pocas conversaciones (Código de error: Has alcanzado tu límite de tasa. Inténtalo de nuevo más tarde).

Según la documentación oficial de Google, la API de Gemini tiene un nivel gratuito accesible a través de Google AI Studio que está sujeto a límites de tasa para garantizar un uso justo. Estos límites se miden principalmente en Solicitudes por Minuto (RPM) y, para algunos modelos, también en Solicitudes por Día (RPD) y Tokens por Minuto (TPM). Por ejemplo, el modelo estándar gemini-1.0-pro tiene un límite de tasa gratuito de 60 RPM, que generalmente es suficiente para el desarrollo y las pruebas. Estos límites se proporcionan sin cargo y no requieren la configuración de una cuenta de facturación.

Diferentes modelos dentro de la familia Gemini tienen diferentes límites de tasa. Exceder el límite de tasa de un modelo resultará en un error HTTP 429 "Recurso Agotado". Para gestionar esto, los desarrolladores deben implementar el manejo de errores con una estrategia de retroceso exponencial, que implica esperar períodos progresivamente más largos antes de volver a intentar una solicitud. Para aplicaciones que requieren un volumen de solicitudes mayor de lo que permite el nivel gratuito, debes habilitar la facturación en un proyecto de Google Cloud y pasar al plan de pago por uso, que ofrece límites significativamente más altos (ai.google.dev).

Para un mayor rendimiento, puedes crear múltiples cuentas de Google (cada una con su propia clave) y rotarlas, una práctica común entre los desarrolladores que se mantienen dentro de los límites gratuitos.

Visión y Video con la API de Gemini 3.0

Gemini 3 procesa imágenes y video de forma nativa. Ejemplo de código Python para análisis de imágenes:

from google.generativeai.types import File

image_file = genai.upload_file(path="diagram.png")

model = genai.GenerativeModel("gemini-3-pro-preview-11-2025")
response = model.generate_content([
    "Explain this architecture diagram in detail:",
    image_file
])
print(response.text)

La comprensión de video funciona de manera similar: sube un MP4 y haz preguntas sobre el contenido, marcas de tiempo o acciones.

Conclusión

Google permite un acceso sin precedentes a la IA de vanguardia a través de su nivel gratuito. Obtienes una clave en menos de dos minutos, comienzas a llamar a los modelos de vista previa de Gemini 3 Pro de inmediato y construyes aplicaciones sofisticadas sin gastar dinero.

Combina esta capacidad con un cliente API robusto como Apidog, y obtendrás un entorno de desarrollo completo que rivaliza con los servicios de pago. Miles de desarrolladores ya crean prototipos de agentes, sistemas RAG y aplicaciones multimodales de esta manera.

Actúa ahora: dirígete a Google AI Studio, genera tu clave, descarga Apidog y envía tu primera solicitud a Gemini 3. La barrera para construir con la IA de última generación nunca ha sido tan baja.

botón