Creando una aplicación de reconocimiento de voz con Watson, React y Express

Parte 2. Registro en IBM Watson, configuración de keys y claves, ejemplos de uso de la API

Este tutorial se encuentra divido en tres partes, cada una de las cuales se encuentra en los siguientes enlaces:

1. Introducción, instalación de dependencias y configuración de backend
2. Registro en IBM Watson, configuración de keys y claves, ejemplos de uso de la API (Estamos aquí)
3. Integración con ReactJS

Registro en Watson IBM y creación de claves

Vamos a registrar nuestra cuenta en Watson IBM, lo mostraremos paso a paso por medio de imágenes para que el proceso sea sencillo.

Registro de usuario

Entramos a https://www.ibm.com/watson/ y le damos click en Get started for free. Nos aparecerá la siguiente pantalla:

Llenamos el formulario y seguimos las instrucciones, una vez hemos seguido las instrucciones de registro, vamos al dashboard:

Creación de nuevo servicio en Speech-to-text

1. Buscamos los servicios de Watson y entramos.
2. Después vamos a crear un nuevo servicio de Watson, en este caso speech-to-text examinando los servicios que nos ofrecen.
3. Ya que hemos creado el servicio, vamos a crear las llaves.

Las imágenes muestran el proceso de forma más simplificada:

Damos click en Watson para ver los servicios disponibles

Examinamos los servicios y seleccionamos Speech to Text y después le damos click en Añadir servicios

Le damos añadir para generar los tokens

Creamos el proyecto y automáticamente nos arrojará los tokens

Creamos el servicio siguiendo las instrucciones, es importante que solamente se cree con la versión Lite, esto con el único propósitos de evitarnos cargos y poder probar la tecnología.

Generación de credenciales

Para generara tokens, una vez creamos el servicio los arroja de forma automática, pero si no es el caso, tenemos que generarlos por nuestra cuenta.

Buscamos el botón Servicios existentes y seleccionamos el nombre de nuestro proyecto, una vez seleccionado podremos crear nuestras credenciales siguiendo las instrucciones en pantalla.

Seleccionamos Credenciales de servicio

Le damos click en el botón Nueva credencial

Nos saldrá esta pantalla en la que podremos agregar nuestras credenciales

Nos saldrán nuestras credenciales con un formato json en la pantalla de credenciales, ahí podremos copiar nuestras credenciales para utilizarlas en nuestra API.

// Credenciales
{
  "url": "https://stream.watsonplatform.net/speech-to-text/api",
  "username": "nombre de usuario",
  "password": "password"
}

Utilización de claves de API

Una vez nos registramos necesitamos copiar las claves que hemos obtenido utilizando variables de entorno (environment vars), que entre otras cosas nos sirven para proteger nuestros archivos confidenciales, para eso es necesario utilizar un archivo en la raíz de nuestro proyecto, este archivo lleva el nombre: .env , para que git lo ignore es importante agregar este archivo a nuestro file .gitignore

Tendríamos lo siguiente:

// Ahora el archivo se tiene que ver así
# misc
.DS_Store
.env            // Esta línea es la que agregaremos
.env.local
.env.development.local
.env.test.local
.env.production.local

Dentro de .env agregaremos nuestras claves, con el siguiente formato:

SPEECH_TO_TEXT_USERNAME="nombre de usuario de speech-to-text"
SPEECH_TO_TEXT_PASSWORD="password de speech-to-text"

Llaves SSL

Vamos a configurar las claves para correr el servidor en ssl, puedes descargarlas en la carpeta keys del enlace de los ejemplos de watson.

Los archivos los copiamos tal cual y los nombramos de la misma forma, guardándolos en una carpeta keys en la raíz de nuestro proyecto:

Quedarían de la siguiente forma (los puedes copiar de aquí si deseas):

Probando el servidor

Ahora podemos correr el servidor sin problemas, vamos a probarlo para ver que sucede, simplemente ejecutamos node server.js

Y nos tiene que salir el siguiente mensaje en pantalla.

Example IBM Watson Speech JS SDK client app & token server live
 at http://localhost:3002/
Secure server live at https://localhost:3001/

Listo, tenemos nuestra API funcionando, ahora vamos a probar el endpoint de nuestra API, para hacer esto simplemente en nuestro server.js se encuentra la línea:

app.use('/api/speech-to-text/token', function(req, res) {

Esto nos permite saber que nuestro endpoint será:

http://localhost:3002/api/speech-to-text/token

Ahora ya tenemos corriendo nuestro servidor con éxito, simplemente necesitamos integrarlo con React en la siguiente parte de nuestro tutorial.