Descripción general de la API de Gemini Live

La API de Gemini Live permite interacciones de voz y video en tiempo real y de baja latencia con Gemini. Procesa flujos continuos de audio, video o texto para brindar respuestas habladas inmediatas y similares a las de un humano. Esto crea una experiencia de conversación natural para tus usuarios.

Prueba la API de Gemini Live en la consola de Google Cloud

Características clave

La API de Gemini Live ofrece un conjunto integral de funciones para compilar agentes de voz y video sólidos:

  • Alta calidad de audio: La API de Gemini Live proporciona un habla natural y realista en varios idiomas.
  • Compatibilidad con varios idiomas: Conversa en 24 idiomas admitidos.
  • Interrupción: Los usuarios pueden interrumpir el modelo en cualquier momento para tener interacciones responsivas.
  • Diálogo afectivo: Adapta el estilo y el tono de la respuesta para que coincidan con la expresión de entrada del usuario.
  • Audio proactivo: Te permite controlar cuándo responde el modelo y en qué contextos.
  • Uso de herramientas: Integra herramientas como la llamada a funciones y la Búsqueda de Google para interacciones dinámicas.
  • Transcripciones de audio: Proporciona transcripciones de texto de la entrada del usuario y la salida del modelo.
  • Traducción de voz a voz: (Experimental) Se optimizó para la traducción de baja latencia entre idiomas.

Especificaciones técnicas

En la siguiente tabla, se describen las especificaciones técnicas de la API de Gemini Live:

Categoría Detalles
Modalidades de entrada Audio (audio PCM sin procesar de 16 bits, 16 kHz, little-endian), imágenes o video (JPEG de 1 FPS), texto
Modalidades de salida Audio (audio PCM sin procesar de 16 bits, 24 kHz, little-endian), texto
Protocolo Conexión de WebSocket con estado (WSS)

Modelos compatibles

Los siguientes modelos admiten la API de Gemini Live. Selecciona el modelo adecuado según tus requisitos de interacción.

ID de modelo Disponibilidad Caso de uso Características clave
gemini-live-2.5-flash-preview-native-audio-09-2025 Versión preliminar pública Rentabilidad en agentes de voz en tiempo real Audio nativo
Transcripciones de audio
Detección de actividad de voz
Diálogo afectivo
Audio proactivo
Uso de herramientas
gemini-2.5-flash-s2st-exp-11-2025 Experimental privado Traducción de voz a voz (experimental) Optimizado para tareas de traducción. Audio nativo
Transcripciones de audio
Uso de herramientas
Traducción de voz a voz

Arquitectura e integración

Existen dos formas principales de integrar la API de Gemini Live en tu aplicación: de servidor a servidor y de cliente a servidor. Elige el que se ajuste a tus requisitos de seguridad y plataforma.

De servidor a servidor

Se recomienda la arquitectura de servidor a servidor para los entornos de producción, como las apps para dispositivos móviles, las herramientas empresariales seguras y la integración de telefonía. Tu aplicación cliente transmite audio a tu servidor de backend seguro. Luego, tu servidor administra la conexión de WebSocket a Google.

Este método mantiene seguras tus claves de API y te permite modificar el audio o agregar lógica antes de enviarlo a Gemini. Sin embargo, agrega una pequeña cantidad de latencia de red.

Del cliente al servidor

La arquitectura cliente-servidor es adecuada para apps web, demostraciones rápidas y herramientas internas. El navegador web se conecta directamente a la API de Gemini Live a través de WebSockets.

Este método proporciona la menor latencia posible y una arquitectura más simple para las demostraciones. Ten en cuenta que este enfoque expone las claves de API al usuario del frontend, lo que genera un riesgo de seguridad. Para la producción, debes usar un proxy cuidadoso o una administración de tokens efímeros.

Comenzar

Selecciona la guía que coincida con tu entorno de desarrollo:

Recomendado por su facilidad de uso

Conéctate a la API de Gemini Live con el SDK de IA generativa, envía un archivo de audio a Gemini y recibe audio como respuesta.

Control de protocolo sin procesar

Conéctate a la API de Gemini Live con WebSockets, envía un archivo de audio a Gemini y recibe audio como respuesta.

Kit de desarrollo de agentes

Crea un agente y usa la transmisión del Kit de desarrollo de agentes (ADK) para habilitar la comunicación por voz y video.

Integraciones a socios

Si prefieres un proceso de desarrollo más simple, puedes usar una de nuestras plataformas asociadas. Estas plataformas ya integraron la API de Gemini Live a través del protocolo WebRTC para optimizar el desarrollo de aplicaciones de audio y video en tiempo real.