Compartir a través de

Creación de un recurso de Traductor

  • Artículo

En este artículo, aprenderá a crear un recurso Translator en Azure Portal. Traductor de Azure AI es un servicio de traducción automática basado en la nube que forma parte de la familia de servicios de Azure AI. Los recursos de Azure son instancias de los servicios que crea. Todas las solicitudes de API a los servicios de Azure AI requieren una dirección URL de punto de conexión y una clave de solo lectura para autenticar el acceso.

Requisitos previos

Para empezar, necesita una cuenta de Azure activa. En caso de no tener ninguna, puede crear una suscripción gratuita de 12 meses.

Creación del recurso

Con su cuenta de Azure puede acceder al servicio Traductor a través de dos tipos de recursos diferentes:

  • Los tipos de recurso de servicio único permiten el acceso a una clave de API y un punto de conexión de un servicio único.

  • Los tipos de recurso de varios servicios permiten el acceso a varias instancias de servicios de Azure AI mediante una única clave de API y un punto de conexión.

Completar los detalles del proyecto y de la instancia

Después de decidir qué tipo de recurso desea usar para acceder al servicio Traductor, puede especificar los detalles del proyecto y la instancia.

  1. Suscripción. Seleccione una de las suscripciones de Azure disponibles.

  2. Grupo de recursos. Puede crear un nuevo grupo de recursos o agregar el recurso a un grupo ya existente que comparta el mismo ciclo de vida, permisos y directivas.

  3. Región del recurso. Elija Global a menos que su empresa o aplicación requiera una región específica. Si planea usar la característica Traducción de documentos con autorización de identidad administrada, elija una región geográfica como Este de EE. UU.

  4. Nombre. Escriba un nombre para el recurso. El nombre que elija debe ser único en Azure.

    Nota:

    Si está usando una característica del Traductor que necesita un punto de conexión de dominio personalizado, como Traducción de documentos, la entrada en el campo name es el parámetro de nombre de dominio personalizado para el punto de conexión.

Asegúrese de escribir el valor correcto en el campo name para garantizar la funcionalidad adecuada.

  1. Plan de tarifa. Seleccione un plan de tarifa que satisfaga sus necesidades:

    • Cada suscripción tiene un plan gratuito.
    • El plan gratuito tiene las mismas características y funcionalidades que los planes de pago y no expira.
    • Solo hay un recurso de nivel gratuito disponible por suscripción.
    • La traducción de documentos se admite en los niveles de pago. Language Studio solo admite los niveles de instancia S1 o D3. Si solo quiere probar Traducción de documentos, seleccione el nivel de instancia S1 estándar.

  2. Si ha creado un recurso de varios servicios, los vínculos que aparecen en la parte inferior de la pestaña Aspectos básicos proporcionan documentación técnica sobre el funcionamiento adecuado del servicio.

  3. Seleccione Revisar + crear.

  4. Revise los términos de servicio y seleccione Crear para implementar el recurso.

  5. Una vez que el recurso se implemente correctamente, seleccione Ir al recurso.

Claves de autenticación y dirección URL del punto de conexión

Todas las solicitudes de API de servicios de Azure AI requieren una dirección URL de punto de conexión y una clave de solo lectura para la autenticación.

  • Claves de autenticación. La clave es una cadena única que se pasa en cada solicitud al servicio Translator. Puede pasar la clave mediante un parámetro de cadena de consulta o mediante su especificación en el encabezado de solicitud HTTP.

  • Dirección URL del punto de conexión. Use el punto de conexión Global en la solicitud de la API a menos que necesite una región de Azure o un punto de conexión personalizado específico. Para obtener más información, consulte Direcciones URL base. La dirección URL del punto de conexión Global es api.cognitive.microsofttranslator.com.

Obtención de las claves y el punto de conexión de autenticación

Para autenticar su conexión con su recurso de Traductor, necesita la clave y el punto de conexión de su recurso.

  1. Una vez implementado el nuevo recurso, seleccione Ir al recurso o vaya a la página de recursos.
  2. En el panel de navegación de la izquierda, en Administración de recursos, seleccione Claves y punto de conexión.
  3. Copie y pegue las claves y la dirección URL del punto de conexión en una ubicación adecuada, como el Bloc de notas.

Captura de pantalla de Azure Portal que muestra la página Claves y punto de conexión de un recurso de Translator. Las claves y los puntos de conexión están resaltados.

Creación de un cliente de Traducción de texto

Traducción de texto es compatible tanto con puntos de conexión globales como regionales. Una vez que tenga las claves de autenticación, debe crear una instancia de TextTranslationClient, mediante una AzureKeyCredential para la autenticación, para interactuar con el servicio de Traducción de texto:

  • Para crear un TextTranslationClient mediante un punto de conexión de recursos global, necesita la clave de API de recursos:

      AzureKeyCredential credential = new('<apiKey>');
  TextTranslationClient client = new(credential);

  • Para crear un TextTranslationClient mediante un punto de conexión de recursos regional, necesita la clave de API de recursos y el nombre de la región donde se encuentra el recurso:

     AzureKeyCredential credential = new('<apiKey>');
 TextTranslationClient client = new(credential, '<region>');

Eliminación de un recurso o un grupo de recursos

Advertencia

Al eliminar un grupo de recursos se eliminan también todos los recursos contenidos en el mismo.

Para eliminar el recurso:

  1. Busque y seleccione Grupos de recursos en Azure Portal y seleccione el grupo de recursos.
  2. Seleccione los recursos que se van a eliminar seleccionando la casilla adyacente.
  3. Seleccione Eliminar en el menú superior cerca del borde derecho.
  4. Escriba eliminar en el cuadro de diálogo Eliminar recursos.
  5. Seleccione Eliminar.

Para eliminar el grupo de recursos:

  1. Vaya al grupo de recursos en Azure Portal.
  2. Seleccione Eliminar grupo de recursos en la barra de menús superior.
  3. Para confirmar la solicitud de eliminación, escriba el nombre del grupo de recursos y seleccione Eliminar.

Introducción a las API REST de Traductor de Azure AI

En nuestro inicio rápido, aprenderá a usar el servicio Translator con las API REST.

Introducción a Translator

Pasos siguientes

Obtenga más información sobre las características del Traductor de Azure AI: