arrow_back

Comienza a usar la API de Gemini en Vertex AI con cURL

Acceder Unirse
Obtén acceso a más de 700 labs y cursos

Comienza a usar la API de Gemini en Vertex AI con cURL

Lab 45 minutos universal_currency_alt 5 créditos show_chart Intermedio
info Es posible que este lab incorpore herramientas de IA para facilitar tu aprendizaje.
Obtén acceso a más de 700 labs y cursos

GSP1228

Logotipo de los labs de autoaprendizaje de Google Cloud

Descripción general

En este lab, aprenderás a usar la API de Gemini en Vertex AI con comandos cURL para interactuar con el modelo Gemini 2.0 Flash (gemini-2.0-flash). Aprenderás a generar texto a partir de una instrucción, agregar parámetros de modelo, chatear y generar texto a partir de imágenes y videos.

Gemini

Gemini es una familia de potentes modelos de IA generativa desarrollados por Google DeepMind que son capaces de comprender y generar varias formas de contenido, como texto, código, imágenes, audio y video.

API de Gemini en Vertex AI

La API de Gemini en Vertex AI proporciona una interfaz unificada para interactuar con modelos de Gemini. Esto permite que los desarrolladores integren fácilmente estas potentes capacidades de IA a sus aplicaciones. Para conocer los detalles más recientes y las funciones específicas de las últimas versiones, consulta la documentación oficial de Gemini.

Modelos de Gemini

  • Gemini Pro: Se diseñó para tareas de razonamiento complejo, como las siguientes:
    • Analizar y resumir grandes cantidades de información.
    • Razonamiento multimodal sofisticado (en texto, código, imágenes, etc.).
    • Resolución de problemas eficaz con bases de código complejas.
  • Gemini Flash: Optimizado para velocidad y eficiencia, con las siguientes características:
    • Tiempos de respuesta de menos de un segundo y alta capacidad de procesamiento.
    • Alta calidad a un costo más bajo para una amplia variedad de tareas.
    • Funciones multimodales mejoradas, incluidas la comprensión espacial, nuevas modalidades de resultados (texto, audio, imágenes) y el uso de herramientas nativas (Búsqueda de Google, ejecución de código y funciones de terceros).

Requisitos previos

Antes de comenzar este lab, debes tener los siguientes conocimientos:

  • Programación de Python básica
  • Conceptos generales sobre APIs
  • Ejecución de código de Python en un notebook de Jupyter en Vertex AI Workbench

Objetivos

En este lab, aprenderás a realizar las siguientes tareas:

  • Instalar el SDK de Python
  • Usar la API de Gemini en Vertex AI para interactuar con cada modelo
  • Usar el modelo Gemini 2.0 Flash (gemini-2.0-flash) para generar texto a partir de imágenes, instrucciones de texto y video

Configuración y requisitos

Antes de hacer clic en el botón Comenzar lab

Lee estas instrucciones. Los labs cuentan con un temporizador que no se puede pausar. El temporizador, que comienza a funcionar cuando haces clic en Comenzar lab, indica por cuánto tiempo tendrás a tu disposición los recursos de Google Cloud.

Este lab práctico te permitirá realizar las actividades correspondientes en un entorno de nube real, no en uno de simulación o demostración. Para ello, se te proporcionan credenciales temporales nuevas que utilizarás para acceder a Google Cloud durante todo el lab.

Para completar este lab, necesitarás lo siguiente:

  • Acceso a un navegador de Internet estándar. Se recomienda el navegador Chrome.
Nota: Usa una ventana del navegador privada o de incógnito (opción recomendada) para ejecutar el lab. Así evitarás conflictos entre tu cuenta personal y la cuenta de estudiante, lo que podría generar cargos adicionales en tu cuenta personal.
  • Tiempo para completar el lab (recuerda que, una vez que comienzas un lab, no puedes pausarlo).
Nota: Usa solo la cuenta de estudiante para este lab. Si usas otra cuenta de Google Cloud, es posible que se apliquen cargos a esa cuenta.

Cómo iniciar tu lab y acceder a la consola de Google Cloud

  1. Haz clic en el botón Comenzar lab. Si debes pagar por el lab, se abrirá un diálogo para que selecciones la forma de pago. A la izquierda, se encuentra el panel Detalles del lab, que tiene estos elementos:

    • El botón para abrir la consola de Google Cloud
    • El tiempo restante
    • Las credenciales temporales que debes usar para el lab
    • Otra información para completar el lab, si es necesaria
  2. Haz clic en Abrir la consola de Google Cloud (o haz clic con el botón derecho y selecciona Abrir el vínculo en una ventana de incógnito si ejecutas el navegador Chrome).

    El lab inicia recursos y abre otra pestaña en la que se muestra la página de acceso.

    Sugerencia: Ordena las pestañas en ventanas separadas, una junto a la otra.

    Nota: Si ves el diálogo Elegir una cuenta, haz clic en Usar otra cuenta.
  3. De ser necesario, copia el nombre de usuario a continuación y pégalo en el diálogo Acceder.

    {{{user_0.username | "Username"}}}

    También puedes encontrar el nombre de usuario en el panel Detalles del lab.

  4. Haz clic en Siguiente.

  5. Copia la contraseña que aparece a continuación y pégala en el diálogo Te damos la bienvenida.

    {{{user_0.password | "Password"}}}

    También puedes encontrar la contraseña en el panel Detalles del lab.

  6. Haz clic en Siguiente.

    Importante: Debes usar las credenciales que te proporciona el lab. No uses las credenciales de tu cuenta de Google Cloud. Nota: Usar tu propia cuenta de Google Cloud para este lab podría generar cargos adicionales.
  7. Haz clic para avanzar por las páginas siguientes:

    • Acepta los Términos y Condiciones.
    • No agregues opciones de recuperación o autenticación de dos factores (esta es una cuenta temporal).
    • No te registres para obtener pruebas gratuitas.

Después de un momento, se abrirá la consola de Google Cloud en esta pestaña.

Nota: Para acceder a los productos y servicios de Google Cloud, haz clic en el menú de navegación o escribe el nombre del servicio o producto en el campo Buscar. Ícono del menú de navegación y campo de búsqueda

Tarea 1: Abre el notebook en Vertex AI Workbench

  1. En el menú de navegación (Ícono del menú de navegación) de la consola de Google Cloud, haz clic en Vertex AI > Workbench.

  2. Busca la instancia y haz clic en el botón Abrir JupyterLab.

La interfaz de JupyterLab para tu instancia de Workbench se abrirá en una pestaña nueva del navegador.

Nota: Si no ves notebooks en JupyterLab, sigue estos pasos adicionales para restablecer la instancia:

1. Cierra la pestaña del navegador de JupyterLab y vuelve a la página principal de Workbench.

2. Selecciona la casilla de verificación junto al nombre de la instancia y haz clic en Restablecer.

3. Después de que se vuelva a habilitar el botón Abrir JupyterLab, espera un minuto y, luego, haz clic en Abrir JupyterLab.

Tarea 2: Configura el notebook

  1. Abre el archivo .

  2. En el cuadro de diálogo Select Kernel, elige Python 3 en la lista de kernels disponibles.

  3. Ejecuta las secciones Getting Started e Import libraries del notebook.

    • Para Project ID, usa , y para Location, usa .
Nota: Puedes omitir las celdas del notebook que tienen la indicación Colab only. Si recibes una respuesta 429 de cualquiera de las ejecuciones de celda del notebook, espera 1 minuto antes de volver a ejecutar la celda para continuar.

En las siguientes secciones, ejecutarás las celdas del notebook para ver cómo usar la API de Gemini en Vertex AI con comandos cURL y, así, interactuar con el modelo Gemini 2.0 Flash (gemini-2.0-flash).

Tarea 3: Usa el modelo Gemini Flash

El modelo Gemini 2.0 Flash (gemini-2.0-flash) está diseñado para tareas de lenguaje natural como clasificación, resumen, extracción y escritura. En esta tarea, aprenderás a usar Gemini 2.0 Flash para generar texto a partir de una instrucción.

  1. En esta tarea, ejecutarás las celdas del notebook para ver cómo usar el modelo Gemini Flash para generar texto a partir de una instrucción de texto.
Nota: Guarda la secuencia de comandos del notebook antes de hacer clic en el botón Revisar mi progreso en cada tarea.

Haz clic en Revisar mi progreso para verificar el objetivo. Generar texto a partir de la instrucción de texto

Generar conversaciones de varios turnos a partir de la instrucción de chat Ejecutar la celda de llamada a función en el notebook

Tarea 4: Entrada multimodal

Gemini 2.0 Flash (gemini-2.0-flash) es un modelo multimodal que permite agregar imágenes y videos a las instrucciones de texto o chat para recibir una respuesta de texto.

  1. En esta tarea, ejecutarás las celdas del notebook para ver cómo usar el modelo de Gemini 2.0 Flash para generar texto a partir de una imagen de un archivo local, una imagen de Google Cloud Storage y un archivo de video.

Haz clic en Revisar mi progreso para verificar el objetivo. Generar texto a partir del archivo de imagen

Generar texto a partir del archivo de video

¡Felicitaciones!

¡Felicitaciones! En este lab, aprendiste a usar la API de Gemini en Vertex AI con comandos cURL para interactuar con el modelo Gemini 2.0 Flash (gemini-2.0-flash) para generar texto, agregar parámetros del modelo, chatear, generar texto a partir de una imagen local, generar texto a partir de una imagen en Google Cloud Storage y generar texto a partir de un archivo de video.

Próximos pasos/Más información

Consulta los siguientes recursos para obtener más información sobre Gemini:

Capacitación y certificación de Google Cloud

Recibe la formación que necesitas para aprovechar al máximo las tecnologías de Google Cloud. Nuestras clases incluyen habilidades técnicas y recomendaciones para ayudarte a avanzar rápidamente y a seguir aprendiendo. Para que puedas realizar nuestros cursos cuando más te convenga, ofrecemos distintos tipos de capacitación de nivel básico a avanzado: a pedido, presenciales y virtuales. Las certificaciones te ayudan a validar y demostrar tus habilidades y tu conocimiento técnico respecto a las tecnologías de Google Cloud.

Última actualización del manual: 11 de julio de 2025

Prueba más reciente del lab: 11 de julio de 2025

Copyright 2025 Google LLC. All rights reserved. Google y el logotipo de Google son marcas de Google LLC. Los demás nombres de productos y empresas pueden ser marcas de las respectivas empresas a las que estén asociados.

Antes de comenzar

  1. Los labs crean un proyecto de Google Cloud y recursos por un tiempo determinado
  2. .
  3. Los labs tienen un límite de tiempo y no tienen la función de pausa. Si finalizas el lab, deberás reiniciarlo desde el principio.
  4. En la parte superior izquierda de la pantalla, haz clic en Comenzar lab para empezar

Usa la navegación privada

  1. Copia el nombre de usuario y la contraseña proporcionados para el lab
  2. Haz clic en Abrir la consola en modo privado

Accede a la consola

  1. Accede con tus credenciales del lab. Si usas otras credenciales, se generarán errores o se incurrirá en cargos.
  2. Acepta las condiciones y omite la página de recursos de recuperación
  3. No hagas clic en Finalizar lab, a menos que lo hayas terminado o quieras reiniciarlo, ya que se borrará tu trabajo y se quitará el proyecto

Este contenido no está disponible en este momento

Te enviaremos una notificación por correo electrónico cuando esté disponible

¡Genial!

Nos comunicaremos contigo por correo electrónico si está disponible

Un lab a la vez

Confirma para finalizar todos los labs existentes y comenzar este

Usa la navegación privada para ejecutar el lab

Usa una ventana de navegación privada o de Incógnito para ejecutar el lab. Así evitarás cualquier conflicto entre tu cuenta personal y la cuenta de estudiante, lo que podría generar cargos adicionales en tu cuenta personal.