Quickstart: Azure Cognitive Services Translator

Probeer de nieuwste versie van Azure Translator. In deze quickstart gaat u aan de slag met de Translator-service om tekst te vertalen met behulp van een programmeertaal van uw keuze of de REST API. Voor dit project raden we u aan de gratis prijscategorie (F0) te gebruiken terwijl u de technologie leert en later een upgrade uitvoert naar een betaalde laag voor productie.

Vereisten

U hebt een actief Azure-abonnement nodig om aan de slag te gaan. Als u geen Azure-abonnement hebt, kunt u er gratis een maken

  • Zodra u uw Azure-abonnement hebt, maakt u een Translator-resource in de Azure Portal.

  • Nadat uw resource is geïmplementeerd, selecteert u Ga naar resource en haalt u uw sleutel en eindpunt op.

    • U hebt de sleutel en het eindpunt van de resource nodig om uw toepassing te verbinden met de Translator-service. Verderop in de quickstart plakt u uw sleutel en eindpunt in de code. U vindt deze waarden op de pagina Azure Portal Sleutels en eindpunt:

      Schermopname: Azure Portal pagina sleutels en eindpunt.

      Notitie

      • Voor deze quickstart is het raadzaam om een algemene translator text-resource met één service te gebruiken.
      • Met een globale resource met één service voegt u één autorisatieheader (Ocp-Apim-Subscription-key) toe aan de REST API-aanvraag. De waarde voor Ocp-Apim-Subscription-key is uw geheime Azure-sleutel voor uw Translator Text-abonnement.
      • Als u ervoor kiest om de Cognitive Services met meerdere services of regionale Translator-resource te gebruiken, zijn twee verificatieheaders vereist: (Ocp-Api-Subscription-Key en Ocp-Apim-Subscription-Region). De waarde voor Ocp-Apim-Subscription-Region is de regio die is gekoppeld aan uw abonnement.
      • Zie Text Translator REST API-headers voor meer informatie over het gebruik van de koptekst Ocp-Apim-Subscription-Region.

Kopteksten

Als u de Translator-service wilt aanroepen via de REST API, moet u bij elke aanvraag de volgende headers opnemen. Maakt u zich geen zorgen, we nemen de headers voor u op in de voorbeeldcode voor elke programmeertaal.

Zie deTranslator v3-naslaghandleiding voor meer informatie over de opties voor Translator-verificatie.

Header Waarde Voorwaarde
Ocp-Apim-Subscription-Key Uw Translator-servicesleutel van de Azure Portal. Vereist
Ocp-Apim-Subscription-Region De regio waar uw resource is gemaakt. Vereist bij gebruik van een Cognitive Services-resource met meerdere services of regionale (niet-globale) resources.
Optioneel bij gebruik van een algemene Translator-resource met één service.
Content-Type Het inhoudstype van de nettolading. De geaccepteerde waarde is application/json of charset=UTF-8. Vereist
Content-Length De lengte van de aanvraagbody . Optioneel

Belangrijk

Vergeet niet de sleutel uit uw code te verwijderen wanneer u klaar bent, en plaats deze sleutel nooit in het openbaar. Gebruik voor productie een veilige manier om uw referenties op te slaan en te openen, zoals Azure Key Vault. Zie het artikelCognitive Services-beveiliging voor meer informatie.

Tekst vertalen

De kernbewerking van de Translator-service is het vertalen van tekst. In deze quickstart maakt u een aanvraag met behulp van een programmeertaal van uw keuze die één bron (from) nodig heeft en twee uitvoerwaarden () biedt.to Vervolgens bekijken we enkele parameters die kunnen worden gebruikt om zowel de aanvraag als het antwoord aan te passen.

Uw Visual Studio-project instellen

  1. Zorg ervoor dat u de huidige versie van Visual Studio IDE hebt.

    Tip

    Als Visual Studio nieuw voor u is, probeert u de learn-module Inleiding tot Visual Studio .

  2. Open Visual Studio.

  3. Kies op de pagina Start de optie Een nieuw project maken.

    Schermopname: het startvenster van Visual Studio.

  4. Voer op de pagina Een nieuw project makenconsole in het zoekvak in. Kies de sjabloon Consoletoepassing en kies vervolgens Volgende.

    Schermopname: de pagina Voor het maken van een nieuw project in Visual Studio.

  5. Voer translator_quickstart in het dialoogvenster Uw nieuwe project configureren in het vak Projectnaam in. Laat het selectievakje Oplossing en project in dezelfde map plaatsen uitgeschakeld en selecteer Volgende.

    Schermopname: het dialoogvenster Nieuw project configureren van Visual Studio.

  6. Controleer in het dialoogvenster Aanvullende informatie of .NET 6.0 (langetermijnondersteuning) is geselecteerd. Laat het selectievakje 'Geen instructies op het hoogste niveau gebruiken' uitgeschakeld en selecteer Maken.

    Schermopname: het dialoogvenster aanvullende informatie van Visual Studio.

Installeer het newtonsoft.json-pakket met NuGet

  1. Klik met de rechtermuisknop op uw translator_quickstart project en selecteer NuGet-pakketten beheren... .

    Schermopname van het zoekvak van het NuGet-pakket.

  2. Selecteer het tabblad Bladeren en typ Newtonsoft.json.

    Schermopname van het installatievenster van het NuGet-pakket.

  3. Selecteer Installeren in het rechter venster pakketbeheer om het pakket toe te voegen aan uw project.

    Schermopname van de knop NuGet-pakket installeren.

Uw C#-toepassing bouwen

Notitie

  • Vanaf .NET 6 genereren nieuwe projecten die gebruikmaken van de console sjabloon een nieuwe programmastijl die verschilt van eerdere versies.
  • De nieuwe uitvoer maakt gebruik van recente C#-functies die de code vereenvoudigen die u nodig hebt om te schrijven.
  • Wanneer u de nieuwere versie gebruikt, hoeft u alleen de hoofdtekst van de Main methode te schrijven. U hoeft geen instructies op het hoogste niveau, algemene gebruiksinstructies of impliciete gebruiksinstructies op te nemen.
  • Zie Nieuwe C#-sjablonen genereren instructies op het hoogste niveau voor meer informatie.
  1. Open het bestand Program.cs .

  2. Verwijder de bestaande code, inclusief de regel Console.Writeline("Hello World!"). Kopieer en plak het codevoorbeeld in het bestand Program.cs van uw toepassing. Zorg ervoor dat u de sleutelvariabele bijwerkt met de waarde van uw Azure Portal Translator-exemplaar:

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);
        }
    }
}

Uw C#-toepassing uitvoeren

Nadat u een codevoorbeeld aan uw toepassing hebt toegevoegd, kiest u de groene startknop naast formRecognizer_quickstart om uw programma te bouwen en uit te voeren of drukt u op F5.

Schermopname van de knop Programma uitvoeren in Visual Studio.

Vertaaluitvoer:

Na een geslaagde aanroep ziet u het volgende antwoord:

[
    {
        "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"
            }
        ]
    }
]

Volgende stappen

Dat is het, gefeliciteerd! U hebt geleerd hoe u de Translator-service kunt gebruiken om tekst te vertalen.

Bekijk onze documentatie over procedures en ga dieper in op de mogelijkheden van de vertaalservice: