Compartir a través de


Inicio rápido: API de REST del Traductor de AI de Azure

Pruebe la última versión del Traductor de Azure AI. Si sigue este inicio rápido, podrá comenzar a usar el servicio Translator para traducir texto mediante un lenguaje de programación de su elección o la API de REST. Para este proyecto, se recomienda usar el plan de tarifa gratuito (F0), mientras se familiariza con la tecnología y, posteriormente, actualizarlo a un nivel de pago para producción.

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.

  • 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:

      Captura de pantalla: página Claves y punto de conexión de Azure Portal.

      Nota

      • Para esta guía de inicio rápido, se recomienda usar un recurso global de servicio único de Translator Text.
      • 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.
      • Si decide utilizar un recurso de Translator multiservicio o regional de Azure AI, se requerirán dos cabeceras de autenticación: (Ocp-Api-Subscription-Key y Ocp-Apim-Subscription-Region). El valor de Ocp-Apim-Subscription-Region es la región asociada a la suscripción.
      • Para más información sobre cómo utilizar el encabezado Ocp-Apim-Subscription-Region, consulteEncabezados de la API de REST de traducción de texto.

encabezados

Para llamar al servicio Translator a través de la API de REST, debe incluir los siguientes encabezados en cada solicitud. No se preocupe por el código de ejemplo para cada lenguaje de programación, ya que este ya incluye estos encabezados.

Para obtener más información sobre las opciones de autenticación para Translator, consulte la guía de referencia de Translator v3.

Encabezado Value Condición
Ocp-Apim-Subscription-Key En este encabezado se incluye la clave de servicio de Translator de Azure Portal. Obligatorio
Ocp-Apim-Subscription-Region La región donde se creó el recurso. - Requerido cuando se utiliza un recurso multiservicio o regional (geográfico) de Azure AI como West US.
- Opcional cuando se utiliza un Recurso de Traductor global de servicio único.
Content-Type En este encabezado se especifica el tipo de contenido de la carga. Los valores que se aceptan son application/json o charset=UTF-8. Obligatorio
Content-Length Este encabezado especifica la longitud del cuerpo de la solicitud. Opcional

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, consulte el artículo sobre seguridad de los servicios Azure AI.

Traducir texto

La operación básica del servicio Translator consiste en traducir texto. En este inicio rápido creará una solicitud, mediante un lenguaje de programación de su elección, que tome un único origen (from) y proporcione dos salidas (to). Luego, conocerá algunos parámetros que se pueden usar para ajustar tanto la solicitud como la respuesta.

Para obtener información detallada sobre los límites de solicitud del servicio de Traductor de Azure AI, veaLímites de solicitud de traducción de texto.

Configuración del proyecto de Visual Studio

  1. Asegúrese de que tiene instalada la versión más reciente del IDE de Visual Studio.

    Sugerencia

    Si es la primera vez que usa Visual Studio, pruebe el módulo de Learn Introducción a Visual Studio.

  2. Abra Visual Studio.

  3. En la página Inicio, seleccione Crear un nuevo proyecto.

    Captura de pantalla: ventana de inicio de Visual Studio.

  4. En la página Crear un proyecto, escriba consola en el cuadro de búsqueda. Elija la plantilla Aplicación de consola y, a continuación, seleccione Siguiente.

    Captura de pantalla: página Crear un proyecto de Visual Studio.

  5. En la ventana de diálogo Configure su nuevo proyecto, escriba translator_quickstart en el cuadro Nombre de proyecto. Deje desactivada la casilla "Colocar la solución y el proyecto en el mismo directorio" y seleccione el botón Siguiente.

    Captura de pantalla: ventana de diálogo Configure su nuevo proyecto de Visual Studio.

  6. En la ventana de diálogo Información adicional, asegúrese de que esté seleccionado el elemento .NET 6.0 (compatibilidad a largo plazo). Deje la casilla "No usar instrucciones de nivel superior" desactivada y seleccione Crear.

    Captura de pantalla: ventana de diálogo de información adicional de Visual Studio.

Instalación del paquete Newtonsoft.json con NuGet

  1. Haga clic con el botón derecho sobre el proyecto formRecognizer_quickstart y seleccione Administrar paquetes NuGet...

    Captura de pantalla del cuadro de búsqueda de paquetes NuGet.

  2. Seleccione la pestaña "Examinar" y escriba Newtonsoft.json.

    Captura de pantalla de la ventana de instalación de paquetes NuGet.

  3. Para agregar el paquete al proyecto, seleccione Instalar en la ventana del administrador de paquetes derecha.

    Captura de pantalla del botón de instalación de paquetes NuGet.

Compilación de la aplicación de C#

Nota

  • A partir de .NET 6, los nuevos proyectos que usan la plantilla console generan un nuevo estilo de programa que difiere de las versiones anteriores.
  • El nuevo tipo de salida usa características recientes de C# que simplifican el código que debe escribir.
  • Cuando se usa la versión más reciente, solo es necesario escribir el cuerpo del método Main. Es decir, no es necesario incluir instrucciones de nivel superior, directivas Using globales o directivas Using implícitas.
  • Para obtener más información, consulte Las nuevas plantillas de C# generan instrucciones de nivel superior.
  1. Abra el archivo Program.cs.

  2. Elimine el código preexistente, incluida la línea Console.WriteLine("Hello World!"). Copie y pegue el código de ejemplo en el archivo Program.cs de la aplicación. Asegúrese de actualizar la variable de clave con el valor correspondiente de la instancia de Translator de Azure Portal:

using System.Text;
using Newtonsoft.Json;

class Program
{
    private static readonly string key = "<your-translator-key>";
    private static readonly string endpoint = "https://api.cognitive.microsofttranslator.com";

    // location, also known as region.
    // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
    private static readonly string location = "<YOUR-RESOURCE-LOCATION>";

    static async Task Main(string[] args)
    {
        // Input and output languages are defined as parameters.
        string route = "/translate?api-version=3.0&from=en&to=fr&to=zu";
        string textToTranslate = "I would really like to drive your car around the block a few times!";
        object[] body = new object[] { new { Text = textToTranslate } };
        var requestBody = JsonConvert.SerializeObject(body);

        using (var client = new HttpClient())
        using (var request = new HttpRequestMessage())
        {
            // Build the request.
            request.Method = HttpMethod.Post;
            request.RequestUri = new Uri(endpoint + route);
            request.Content = new StringContent(requestBody, Encoding.UTF8, "application/json");
            request.Headers.Add("Ocp-Apim-Subscription-Key", key);
            // location required if you're using a multi-service or regional (not global) resource.
            request.Headers.Add("Ocp-Apim-Subscription-Region", location);

            // Send the request and get response.
            HttpResponseMessage response = await client.SendAsync(request).ConfigureAwait(false);
            // Read response as a string.
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

Ejecute la aplicación C#

Una vez que agregue una muestra de código a su aplicación, elija el botón Iniciar verde junto a formRecognizer_quickstart para crear y ejecutar su programa, o pulse F5.

Captura de pantalla del botón Ejecutar programa en Visual Studio

Salida del servicio Translation:

Si realiza una llamada correcta, debería ver la siguiente respuesta:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "translations": [
            {
                "text": "J'aimerais vraiment conduire votre voiture autour du pâté de maisons plusieurs fois!",
                "to": "fr"
            },
            {
                "text": "Ngingathanda ngempela ukushayela imoto yakho endaweni evimbelayo izikhathi ezimbalwa!",
                "to": "zu"
            }
        ]
    }
]

Pasos siguientes

Eso es todo, ¡enhorabuena! Acaba de aprender cómo usar el servicio Translator para traducir texto.

Explore nuestra documentación paso a paso y profundice en las funcionalidades del servicio Translator: