Share via

Introducción a la traducción sincrónica

  • Artículo

La traducción de documentos es una característica de traducción automática basada en la nube del servicio Traductor de Azure AI. P traducir varios documentos complejos en todos los idiomas y dialectos admitidos a la vez que se conserva la estructura del documento original y el formato de datos.

La traducción sincrónica admite el procesamiento de respuesta inmediata de archivos de página única. El proceso de traducción sincrónica no requiere una cuenta de Azure Blob Storage. La respuesta final contiene el documento traducido y se devuelve directamente al cliente que realiza la llamada.

Comencemos.

Requisitos previos

Necesita una suscripción de Azure activa. Si no tiene una suscripción de Azure, puede crear una gratis.

  • Cuando tenga la suscripción, cree un recurso de Translator en Azure Portal.

    Nota:

    • Para este inicio rápido, se recomienda usar un recurso global de servicio único de traductor de texto a menos que la empresa o la aplicación requieran una región específica. Si planea usar una identidad administrada asignada por el sistema para la autenticación, elija una región geográfica como Oeste de EE. UU.
    • Con el recurso global de un solo servicio, incluirá un encabezado de autorización (Ocp-Apim-Subscription-key) con la solicitud de la API de REST. El valor de Ocp-Apim-Subscription-key es la clave secreta de Azure para la suscripción de Translator Text.

  • Después de implementar el recurso, seleccione el botón Ir al recurso para obtener la clave y el punto de conexión.

    • Tanto la clave como el punto de conexión del recurso son necesarios para conectar la aplicación al servicio Translator. En una sección posterior de este mismo inicio rápido, va a pegar la clave y el punto de conexión en el código. Puede encontrar estos valores en la página Claves y punto de conexión de Azure Portal.

      Screenshot to document translation key and endpoint location in the Azure portal.

  • Para este proyecto, usaremos la herramienta de línea de comandos cURL para realizar llamadas a la API REST.

    Nota:

    El paquete cURL está preinstalado en la mayoría de las distribuciones tanto de Windows 10 y Windows 11 como de macOS y Linux. Puede comprobar la versión del paquete con los siguientes comandos: Windows: curl.exe -V macOS curl -V Linux: curl --version

  • Si cURL no está instalada, estos son los vínculos de instalación para su plataforma:

Encabezados y parámetros

Para llamar a la característica de traducción sincrónica a través de la API de REST, debe incluir los siguientes encabezados con cada solicitud. No se preocupe, se incluyen los encabezados para usted en el código de ejemplo.

Nota:

Todas las marcas cURL y las opciones de línea de comandos distinguen mayúsculas de minúsculas.

Parámetro de consulta Descripción Condición
-X o --requestPOST La marca -X especifica el método de solicitud para acceder a la API. Obligatorio
{endpoint} Dirección URL del punto de conexión del recurso de traducción de documentos Obligatorio
targetLanguage Especifica el idioma del documento de salida. El idioma de destino debe ser uno de los idiomas admitidos incluidos en el ámbito de traducción. Obligatorio
sourceLanguage Especifica el idioma del documento de entrada. Si no se ha especificado el parámetro sourceLanguage, se aplica la detección de idioma automática para determinar el idioma de origen. Opcional
-H o --header"Ocp-Apim-Subscription-Key:{KEY} Encabezado de solicitud que especifica la clave de recurso de traducción de documentos que autoriza el acceso a la API. Obligatorio
-F o --form Ruta de acceso al documento que desea incluir con la solicitud. Solo se permite un documento de origen. Obligatorio
• document=
• type={contentType}/fileExtension		 • Ruta de acceso a la ubicación del archivo para el documento de origen.•
Tipo de contenido y extensión de archivo.

Ej: "document=@C:\Test\test-file.md;type=text/markdown		 Obligatorio
-o o --output Ruta de acceso de archivo a los resultados de la respuesta. Obligatorio
-F o --form Ruta de acceso a un glosario opcional que se va a incluir con la solicitud. El glosario requiere una marca de --form independiente. Opcional
• glossary=
• type={contentType}/fileExtension		 • Ruta de acceso a la ubicación del archivo del glosario opcional.•
Tipo de contenido y extensión de archivo.

Ej: "glossary=@C:\Test\glossary-file.txt;type=text/plain		 Opcional

✔️ Para obtener más información sobre contentType, consulteFormatos de documento admitidos.

Compilación y ejecución de la solicitud POST

  1. Para este proyecto, necesita un documento de ejemplo. Puede descargar nuestro documento de ejemplo de Microsoft Word para este inicio rápido. El idioma de origen es inglés.

  2. Antes de ejecutar la solicitud POST, reemplace {your-document-translation-endpoint} y {your-key} por los valores de la instancia del servicio de Translator de Azure Portal.

    Importante

    Recuerde quitar la clave del código cuando haya terminado y no hacerla nunca pública. En el caso de producción, use una forma segura de almacenar sus credenciales y acceder a ellas, como Azure Key Vault. Para más información, consulteSeguridad de servicios de Azure AI.

    command prompt/terminal

    
curl -i -X POST "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2023-11-01-preview" -H "Ocp-Apim-Subscription-Key:{your-key}"  -F "document={path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -F "glossary={path-to-your-glossary-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file}"

    PowerShell

    cmd /c curl "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2023-11-01-preview" -i -X POST  -H "Ocp-Apim-Subscription-Key: {your-key}" -F "{path-to-your-document-with-file-extension};type=text/{file-extension}" -o "{path-to-output-file}

    ✔️ Para obtener más información sobre Query parameters, consulteEncabezados y parámetros.

Tras completarse correctamente:

  • El documento traducido se devuelve con la respuesta.
  • El método POST correcto devuelve un código de respuesta 200 OK que indica que el servicio ha creado la solicitud.

Eso es todo, ¡enhorabuena! Acaba de aprender a traducir de forma sincrónica un documento mediante el servicio Traductor de Azure AI.

Pasos siguientes

Traducción por lotes asincrónica