GSP119

Descripción general

La API de Google Cloud Speech permite la integración sencilla de tecnologías de reconocimiento de voz de Google en aplicaciones para desarrolladores. La API de Speech te permite enviar audios y recibir una transcripción de texto del servicio. Para obtener más información, consulta el artículo ¿Qué es la API de Google Cloud Speech?

Qué aprenderás

En este lab, harás lo siguiente para configurar y usar la API de Speech:

• Crear una clave de API
• Crear una solicitud a la API de Speech
• Llamar a la solicitud a la API de Speech

Configuración y requisitos

Antes de hacer clic en el botón Comenzar lab

Lee estas instrucciones. Los labs son cronometrados y no se pueden pausar. El cronómetro, 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 de navegador privada o de Incógnito para ejecutar este 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.

• Tiempo para completar el lab: Recuerda que, una vez que comienzas un lab, no puedes pausarlo.

Nota: Si ya tienes un proyecto o una cuenta personal de Google Cloud, no los uses en este lab para evitar cargos adicionales en tu cuenta.

Ahora que comenzaste el lab, deberás acceder a la consola de Google Cloud.

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

1. Haga clic en el botón Comenzar lab. Si debe pagar por el lab, se abrirá una ventana emergente para que seleccione su forma de pago. A la izquierda, se encuentra el panel Detalles del lab que tiene estos elementos:

   • El botón Abrir la consola de Google
   • Tiempo restante
   • Las credenciales temporales que debe usar para el lab
   • Otra información para completar el lab, si es necesaria

2. Haga clic en Abrir la consola de Google. El lab inicia recursos y abre otra pestaña en la que se muestra la página de acceso.

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

   Nota: Si ve el diálogo Elegir una cuenta, haga clic en Usar otra cuenta.

3. Si es necesario, copie el nombre de usuario del panel Detalles del lab y péguelo en el cuadro de diálogo Acceder. Haga clic en Siguiente.

4. Copie la contraseña del panel Detalles del lab y péguela en el cuadro de diálogo de bienvenida. Haga clic en Siguiente.

   Importante: Debe usar las credenciales del panel de la izquierda. No use sus credenciales de Google Cloud Skills Boost. Nota: Usar su propia Cuenta de Google podría generar cargos adicionales.

5. Haga clic para avanzar por las páginas siguientes:

   • Acepte los términos y condiciones.
   • No agregue opciones de recuperación o autenticación de dos factores (esta es una cuenta temporal).
   • No se registre para obtener pruebas gratuitas.

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

Nota: Para ver el menú con una lista de los productos y servicios de Google Cloud, haga clic en el Menú de navegación que se encuentra en la parte superior izquierda de la pantalla.

Tarea 1: Crea una clave de API

Dado que usarás curl para enviar una solicitud a la API de Speech, tendrás que generar una clave de API para pasar la URL de nuestra solicitud.

1. Para crear una clave de API, haz clic en el menú de navegación > APIs y servicios > Credenciales.

2. Luego, haz clic en Crear credenciales.

3. En el menú desplegable, selecciona Clave de API.

4. Copia la clave que acabas de generar y haz clic en Cerrar.

Haz clic en Revisar mi progreso para verificar el objetivo.

Crear una clave de API

Ahora que tienes una clave de API, la guardarás como una variable de entorno para no tener que ingresar el valor de esta clave en cada solicitud.

Para realizar los próximos pasos, conéctate mediante SSH a la instancia que se te aprovisionó.

1. En el menú de navegación, selecciona Compute Engine. Deberías ver una linux-instance en la ventana de Instancias de VM.

2. Haz clic en el botón SSH que se encuentra junto a la linux-instance. Se te redireccionará a una shell interactiva.

3. En la línea de comandos, ingresa lo siguiente y, luego, reemplaza <YOUR_API_KEY> por la clave de API que copiaste a partir de la generada con anterioridad.

export API_KEY=<YOUR_API_KEY>

Permanece en esta sesión de SSH durante el resto del lab.

Tarea 2. Crea la solicitud a la API de Speech

Nota: Utilizarás un archivo grabado con anterioridad que se encuentra disponible en Cloud Storage: gs://cloud-samples-tests/speech/brooklyn.flac. Escucha el archivo de audio antes de enviarlo a la API de Speech.

1. Crea request.json en la línea de comandos de SSH. Lo utilizarás para crear la solicitud a la API de Speech:

touch request.json

2. Abre request.json:

nano request.json Nota: Puedes usar el editor de línea de comandos que prefieras (nano, vim, emacs) o gcloud. En este lab se proporcionan instrucciones para nano.

3. Agrega lo siguiente al archivo request.json, con el valor de uri del archivo de audio sin procesar de muestra:

{ "config": { "encoding":"FLAC", "languageCode": "en-US" }, "audio": { "uri":"gs://cloud-samples-tests/speech/brooklyn.flac" } }

4. Presiona Ctrl + x, y para guardar el archivo request.json e Intro para cerrarlo.

El cuerpo de la solicitud tiene un objeto config y otro audio.

En config, se le indica a la API de Speech cómo procesar la solicitud. El parámetro encoding le indica a la API qué tipo de codificación de audio estás usando mientras el archivo se envía a la API. FLAC es el tipo de codificación para los archivos sin procesar. Obtén más información sobre los tipos de codificación en la Guía de RecognitionConfig.

Hay otros parámetros que puedes agregar al objeto config, pero encoding es el único obligatorio.

En el objeto audio, se le pasa a la API el URI del archivo de audio en Cloud Storage.

Haz clic en Revisar mi progreso para verificar el objetivo.

Crear tu solicitud a la API de Speech

Ya estás listo para llamar a la API de Speech.

Tarea 3. Llama a la API de Speech

1. Pasa el cuerpo de la solicitud, junto con la variable de entorno de la clave de API, a la API de Speech con el siguiente comando curl (todo en una sola línea de comandos):

curl -s -X POST -H "Content-Type: application/json" --data-binary @request.json \ "https://speech.googleapis.com/v1/speech:recognize?key=${API_KEY}"

La respuesta debería ser similar a la siguiente:

{ "results": [ { "alternatives": [ { "transcript": "how old is the Brooklyn Bridge", "confidence": 0.98267895 } ] } ] }

El valor transcript mostrará la transcripción de texto que la API de Speech realizó del archivo de audio, mientras que el valor confidence indicará qué tan segura está la API de haber transcrito el audio de forma correcta.

Notarás que llamaste al método syncrecognize en la solicitud anterior. La API de Speech es compatible con la transcripción de voz a texto síncrona y asíncrona. En este ejemplo, enviaste un archivo de audio completo, pero también puedes utilizar el método syncrecognize para realizar una transcripción de voz a texto a partir de una transmisión de audio, mientras el usuario aún está hablando.

Creaste una solicitud a la API de Speech y, luego, llamaste a la API de Speech.

2. Ejecuta el siguiente comando para guardar la respuesta en un archivo result.json:

curl -s -X POST -H "Content-Type: application/json" --data-binary @request.json \ "https://speech.googleapis.com/v1/speech:recognize?key=${API_KEY}" > result.json

Haz clic en Revisar mi progreso para verificar el objetivo.

Llamar a la API de Speech

¡Felicitaciones!

De esta manera, finaliza el lab de autoaprendizaje API de Google Cloud Speech: Qwik Start. Integraste el reconocimiento de voz en una aplicación y, luego, generaste una transcripción desde el servicio.

Finaliza la Quest

Este lab de autoaprendizaje forma parte de la Quest Baseline: Data, ML, AI y la Quest Intro to ML: Language Processing. Una Quest es una serie de labs relacionados que forman una ruta de aprendizaje. Si completas esta Quest, obtendrás una insignia como reconocimiento por tu logro. Puedes hacer públicas tus insignias y agregar vínculos a ellas en tu currículum en línea o en tus cuentas de redes sociales. Inscríbete en cualquier Quest que contenga este lab y obtén un crédito inmediato de finalización. Consulta el catálogo para ver todas las Quests disponibles.

Realiza tu próximo lab

Este lab también forma parte de una serie de labs denominada Qwik Starts. Estos labs están diseñados para ofrecerte una visión general de las numerosas funciones disponibles en Google Cloud. Busca “Qwik Starts” en el catálogo de labs para elegir el próximo lab que quieras completar.

Próximos pasos y más información

• Para ver una serie de labs que se enfocan en esta área, consulta las Quests de Google Cloud Skills Boost. Por ejemplo, Networking Fundamentals in Google Cloud.

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.

Actualización más reciente del manual: 15 de septiembre de 2023

Prueba más reciente del lab: 13 de octubre de 2023

Copyright 2024 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.