Creación de un recurso de Traductor

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

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

1. 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.

2. 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.

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 usa una característica de Traductor que requiere un punto de conexión de dominio personalizado, como Traducción de documentos, el valor que especifique en el campo Nombre será el parámetro del nombre de dominio personalizado del punto de conexión.

5. 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.

6. Si crea 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.

7. Seleccione Revisar + crear.

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

9. Una vez que el recurso se haya implementado 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.

Para autenticar la conexión al recurso Traductor, deberá buscar sus claves y su punto de conexión.

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.

   

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:

1. 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);
   

2. 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>');
   

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.