Google lanzó el 27 de octubre de 2026 la beta de Gemini API CLI, cuyo comando es gemini-api. Es un cliente de Interactions API para llamar a modelos y agentes gestionados desde la terminal, scripts y procesos de integración continua. Permite generar texto y medios, analizar archivos y consultar trabajos en segundo plano sin incorporar una biblioteca de programación al proyecto.
La distinción principal está en el nombre: no es el agente interactivo Gemini CLI, distribuido como @google/gemini-cli. gemini-api funciona como una herramienta que otro programa o agente puede invocar. Tampoco ejecuta los modelos en el ordenador del usuario: las operaciones de inferencia utilizan la API de Google, con sus condiciones de acceso, cuotas y costes correspondientes.
Archivos y salidas pensados para automatizaciones
La guía oficial del cliente describe una decisión útil para encadenar tareas: los comandos de medios y transcripción escriben archivos en disco e imprimen sus rutas. Así, una etapa posterior puede trabajar con una ruta en vez de recibir todo el contenido binario dentro de su contexto.
Un ejemplo hipotético, no ejecutado por Puntoes, sería un proceso que solicita una ilustración, captura la ruta del archivo y la entrega a una etapa de revisión antes de incorporarla a una página. Esto describe un flujo posible; no demuestra ahorro, calidad visual ni fidelidad a una marca.
El cliente no conserva estado local oculto por defecto. Si hay que continuar un trabajo, el programa debe pasar de forma explícita el identificador de interacción anterior, una referencia de archivo subido o el identificador del trabajo en segundo plano. Esa propiedad del cliente no significa que el servicio remoto deje de almacenar solicitudes.
Comprobar una petición antes de enviarla
--usage muestra el árbol de comandos y --schema permite consultar el esquema de las solicitudes. --dry-run valida entradas y muestra la petición HTTP prevista sin conexión, ocultando credenciales. Sirve para comprobar cómo se construye una llamada; no acredita que el modelo vaya a responder correctamente ni que la cuenta tenga acceso al servicio.
Para obtener un único resultado JSON con generate o agent run, se necesita --stream=false junto con -o json o --jq. El modo --agent-mode devuelve errores estructurados por la salida de error. Por defecto no hay preguntas interactivas, salvo que se soliciten mediante --interactive.
Son detalles relevantes en una automatización: el programa necesita distinguir una respuesta de un fallo y evitar quedarse esperando una entrada humana. La documentación separa errores de API o ejecución, de sintaxis y de autenticación mediante códigos de salida.
Qué revisar antes de integrarlo
Google ofrece archivos binarios versionados para macOS, Linux y Windows. Fijar una versión y consultar su ayuda permite revisar los comandos de la instalación concreta. La clave GEMINI_API_KEY debe llegar al proceso desde un almacenamiento de secretos, sin incorporarla al repositorio.
Los archivos locales enviados directamente con -i tienen un límite de 14 MB sin codificar, equivalente a un máximo de petición de 20 MB con base64. Para archivos mayores se utiliza la subida de Files API. Esa API elimina los archivos subidos después de 48 horas; no es una regla general de retención para todas las interacciones.
El cliente admite peticiones HTTP, eventos de servidor y consultas periódicas de estado, pero no WebSockets bidireccionales. Para voz o vídeo en tiempo real, Google remite a Live API y sus bibliotecas de desarrollo.
Por último, conviene revisar el almacenamiento remoto antes de enviar datos reales. La guía permite establecer store: false en el cuerpo de una solicitud compatible. Esto debe distinguirse del cambio reciente de registro en Generate Content: esta CLI se presenta para Interactions API. No hemos instalado el cliente ni realizado llamadas al servicio; esta noticia contrasta su documentación y su anuncio de beta.