Cargando…
No se encontraron resultados.

Create an API Key

Revisar mi progreso

/ 30

Create your Speech API request

Revisar mi progreso

/ 30

Call the Speech API for English language

Revisar mi progreso

/ 20

Call the Speech API for French language

Revisar mi progreso

/ 20

Es posible que este lab incorpore herramientas de IA para facilitar tu aprendizaje.
Este contenido aún no está optimizado para dispositivos móviles.
Para obtener la mejor experiencia, visítanos en una computadora de escritorio con un vínculo que te enviaremos por correo electrónico.

GSP048

Labs de autoaprendizaje de Google Cloud

Descripción general

La API de Speech-to-Text permite transcribir archivos de audio de voz en archivos de texto en más de 80 idiomas.

En este lab, enviarás un archivo de audio a la API de Speech para transcribirlo.

Qué aprenderás

En este lab, explorarás cómo hacer lo siguiente:

  • Crear una solicitud a la API de Speech-to-Text y llamarla con curl
  • Llamar a la API de Speech-to-Text con archivos de audio en distintos idiomas

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 derecha, se encuentra el panel Configuración del lab y acceso, que tiene los siguientes elementos:

    • El botón Abrir la consola de Google Cloud
    • Las credenciales temporales (nombre de usuario y contraseña) que debes usar para este lab
    • Otra información para completar el lab (si es necesaria)

    Ten en cuenta que el cronómetro del lab se encuentra cerca de la parte superior de la página y muestra el tiempo restante.

  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 los 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 Usa 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 Configuración del lab y acceso.

  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 Configuración del lab y acceso.

  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 ni autenticación de dos factores, ya que esta cuenta es 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

Activa Cloud Shell

Cloud Shell es una máquina virtual que cuenta con herramientas para desarrolladores. Ofrece un directorio principal persistente de 5 GB y se ejecuta en Google Cloud. Cloud Shell proporciona acceso de línea de comandos a tus recursos de Google Cloud.

  1. Haz clic en Activar Cloud Shell Ícono de Activar Cloud Shell en la parte superior de la consola de Google Cloud.

  2. Haz clic para avanzar por las siguientes ventanas:

    • Continúa en la ventana de información de Cloud Shell.
    • Autoriza a Cloud Shell para que use tus credenciales para realizar llamadas a la API de Google Cloud.

Cuando te conectes, habrás completado la autenticación, y el proyecto estará configurado con tu Project_ID, . El resultado contiene una línea que declara el Project_ID para esta sesión:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud es la herramienta de línea de comandos de Google Cloud. Viene preinstalada en Cloud Shell y es compatible con la función de autocompletado con tabulador.

  1. Puedes solicitar el nombre de la cuenta activa con este comando (opcional):
gcloud auth list
  1. Haz clic en Autorizar.

Resultado:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`
  1. Puedes solicitar el ID del proyecto con este comando (opcional):
gcloud config list project

Resultado:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Nota: Para obtener toda la documentación de gcloud, en Google Cloud, consulta la guía con la descripción general de gcloud CLI.

Tarea 1: Crea una clave de API

Como debes usar curl para enviar una solicitud a la API de Speech-to-Text, necesitas generar una clave de API para pasar la URL de la solicitud.

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

  2. Haz clic en Crear credenciales y selecciona Clave de API.

  3. En el panel lateral Crear clave de API que aparece, en APIs a las que se puede acceder con esta clave, haz clic en el menú desplegable (Seleccionar APIs).

  4. Busca Cloud Speech-to-Text API o desplázate hasta encontrarla y, luego, marca la casilla.

  5. Haz clic en Aceptar.

  6. Haz clic en Crear.

  7. Copia la clave de API que se generó y haz clic en Cerrar.

Haz clic en Revisar mi progreso para verificar el objetivo.

Crear una clave de API

Ahora, guarda la clave en una variable de entorno para no tener que insertar el valor de la clave de API en cada solicitud.

  1. En la consola de Cloud, haz clic en Activar Cloud Shell en la barra de navegación superior.

  2. Si se te solicita, haz clic en Continuar.

  3. En Cloud Shell, ejecuta lo siguiente, reemplazando <YOUR_API_KEY> por la clave que acabas de copiar:

export API_KEY="<YOUR_API_KEY>"

Tarea 2: Crea tu solicitud a la API

Nota: En este lab, se usa un archivo ya registrado que está disponible en Cloud Storage: gs://cloud-samples-data/speech/brooklyn_bridge.flac. Antes de enviarlo a la API de Speech-to-Text, puedes escuchar este archivo.
  1. Compila la solicitud a la API en un archivo request.json: Crea el archivo JSON request.json:
touch request.json
  1. Abre el archivo con tu editor de línea de comandos de preferencia (nano, vim, emacs) o gcloud y, luego, agrega lo siguiente al archivo request.json, con el valor uri del archivo de audio de muestra sin procesar:
{ "config": { "encoding":"FLAC", "languageCode": "en-US" }, "audio": { "uri":"gs://cloud-samples-data/speech/brooklyn_bridge.flac" } }
  1. Guarda el archivo según sea necesario.

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

En config, le indicas a la API de Speech-to-Text cómo procesar la solicitud.

  • El parámetro encoding le indica a la API qué tipo de codificación de audio usas mientras el archivo se envía a la API. FLAC es el tipo de codificación para archivos .raw (obtén más información sobre los tipos de codificación en la referencia de RecognitionConfig).
  • De forma predeterminada, languageCode queda en inglés si lo dejas fuera de la solicitud.

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

En el objeto audio, debes pasarle a la API el URI del archivo de audio que se guardó en Cloud Storage para este lab.

Haz clic en Revisar mi progreso para verificar el objetivo.

Crear tu solicitud a la API de Speech

Ahora, ya tienes todo para llamar a la API de Speech-to-Text.

Tarea 3: Llama a la API de Speech-to-Text

  1. Pasa el cuerpo de la solicitud, junto con la variable de entorno de la clave de API, a la API 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}" > result.json

Se almacenará tu respuesta en un archivo llamado result.json.

  1. Para ver su contenido, puedes usar lo siguiente:
cat result.json

La respuesta que devuelva el comando curl debería ser similar a lo siguiente:

{ "results": [ { "alternatives": [ { "transcript": "how old is the Brooklyn Bridge", "confidence": 0.98216057 } ], "resultEndTime": "1.770s", "languageCode": "en-us" } ], "totalBilledTime": "15s" }

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

Ten en cuenta que llamaste al método syncrecognize en la solicitud anterior. La API de Speech-to-Text admite tanto la transcripción de voz a texto síncrona como asíncrona.

En este ejemplo, se usó un archivo de audio completo. Sin embargo, también puedes usar el método syncrecognize para hacer una transcripción de voz a texto en transmisión, mientras el usuario sigue hablando.

  1. Sube el archivo result.json de la transcripción en inglés a tu bucket de Cloud Storage:
gcloud storage cp result.json gs://{{{project_0.project_id | PROJECT_ID}}}-speech/result_en.json

Haz clic en Revisar mi progreso para verificar el objetivo.

Llamar a la API de Speech para el idioma inglés

Tarea 4: Transcripción de voz a texto en diferentes idiomas

¿Hablas varios idiomas? La API de Speech-to-Text admite la transcripción de voz a texto en más de 100 idiomas.

Puedes cambiar el parámetro language_code de request.json. En la Guía de idiomas admitidos, encontrarás una lista de los idiomas compatibles con la API.

Prueba un archivo de audio en francés (para obtener una muestra, escucha aquí).

  1. Edita el archivo request.json y cambia el contenido por los parámetros siguientes:
{ "config": { "encoding":"FLAC", "languageCode": "fr" }, "audio": { "uri":"gs://cloud-samples-data/speech/corbeau_renard.flac" } }

  1. Vuelve a ejecutar el comando curl para llamar a Speech-to-Text.

  2. Ve los resultados con el comando siguiente:

cat result.json

Deberías ver la respuesta siguiente:

{ "results": [ { "alternatives": [ { "transcript": "maître corbeau sur un arbre perché Tenait dans son bec un fromage maître Renard par l'odeur alléché lui tint à peu près ce langage et bonjour monsieur du corbeau", "confidence": 0.93855613 } ], "resultEndTime": "12.630s", "languageCode": "fr-fr" } ], "totalBilledTime": "15s" }

Esta es una frase de un cuento infantil en francés de Jean de la Fontaine. Si tienes archivos de audio en otro idioma, puedes intentar agregarlos a Cloud Storage y cambiar el parámetro languageCode de la solicitud.

Nota: Las restricciones y los límites de uso de la API en Speech-to-Text están documentados en el Recurso sobre cuotas y límites.
  1. Sube el archivo result.json de la transcripción en francés a tu bucket de Cloud Storage:
gcloud storage cp result.json gs://{{{project_0.project_id | PROJECT_ID}}}-speech/result_fr.json

Haz clic en Revisar mi progreso para verificar el objetivo.

Llamar a la API de Speech para el idioma francés

¡Felicitaciones!

Hiciste una transcripción de voz a texto con la API de Speech. Pasaste el URI de Cloud Storage de tu archivo de audio a la API y exploraste la alternativa de pasar una cadena codificada en base64 del contenido de tu audio.

Próximos pasos y más información

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: 7 de octubre de 2026

Prueba más reciente del lab: 7 de octubre de 2026

Copyright 2026 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. .
  2. 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.
  3. 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

Podemos enviarte una notificación por correo electrónico cuando esté disponible

¡Genial!

Podemos comunicarnos 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

Usar una ventana de incógnito o de navegación privada es la mejor forma de 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.