Delen via


Quickstart: Azure AI Translator REST API's

Probeer de nieuwste versie van Azure AI 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

Een Azure-abonnement. Als u geen Azure-abonnement hebt, kunt u er gratis een maken.

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

  • Nadat uw resource is geïmplementeerd, selecteert u Ga naar de 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. U plakt uw sleutel en eindpunt verderop in de code in de quickstart. U vindt deze waarden op de pagina Sleutels en eindpunten van Azure Portal:

      Schermopname: Azure Portal-sleutels en eindpuntpagina.

      Notitie

      • Voor deze quickstart wordt u aangeraden een algemene resource van Translator Text met één service te gebruiken.
      • Met een globale resource met één service neemt u één autorisatieheader (Ocp-Apim-Subscription-key) op met de REST API-aanvraag. De waarde voor Ocp-Apim-Subscription-key is uw Azure-geheime sleutel voor uw Translator Text-abonnement.
      • Als u ervoor kiest om een Azure AI-resource voor meerdere services of regionale Translator-resources te gebruiken, zijn er 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 REST API-headers voor tekstomzetting voor meer informatie over het gebruik van de header Ocp-Apim-Subscription-Region.

Kopteksten

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

Zie de naslaghandleiding voor Translator v3 voor meer informatie over translator-verificatieopties.

Koptekst Weergegeven als Conditie
Ocp-Apim-Subscription-Key Uw Translator-servicesleutel vanuit Azure Portal. Vereist
Ocp-Apim-Subscription-Region De regio waar uw resource is gemaakt. Vereist bij het gebruik van een Azure AI-resource voor meerdere services of regionale (geografische) resources, zoals VS - west.
Optioneel bij gebruik van een globale Translator-resource met één service.
Content-Type Het inhoudstype van de nettolading. De geaccepteerde waarde is application/json of charset=UTF-8. Vereist
Lengte van inhoud De lengte van de aanvraagbody . Optioneel

Belangrijk

Vergeet niet de sleutel uit uw code te verwijderen wanneer u klaar bent, en maak deze sleutel nooit openbaar. Gebruik voor productie een veilige manier om uw referenties op te slaan en te openen, zoals Azure Key Vault. Zie het beveiligingsartikel over Azure AI-services voor meer informatie.

Tekst vertalen

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

Zie Aanvraaglimieten voor tekstomzetting voor gedetailleerde informatie over aanvraaglimieten voor Azure AI Translator-service.

uw Visual Studio-project instellen

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

    Tip

    Als u geen kennis hebt met Visual Studio, kunt u de Module Inleiding tot Visual Studio Learn proberen.

  2. Open Visual Studio.

  3. Kies Een nieuw project maken op de startpagina.

    Schermopname: Startvenster van Visual Studio.

  4. Voer op de pagina Een nieuw project maken de console in het zoekvak in. Kies de consoletoepassingssjabloon en kies vervolgens Volgende.

    Schermopname: De nieuwe projectpagina van Visual Studio maken.

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

    Schermopname: het dialoogvenster Nieuw project configureren in Visual Studio.

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

    Schermopname: het dialoogvenster aanvullende informatie van Visual Studio.

Het Newtonsoft.json-pakket installeren met NuGet

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

    Schermopname van het zoekvak voor NuGet-pakketten.

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

    Schermopname van het installatievenster van het NuGet-pakket.

  3. Als u het pakket aan uw project wilt toevoegen, selecteert u installeren in het juiste pakketbeheervenster.

    Schermopname van de installatieknop van het NuGet-pakket.

Uw C#-toepassing bouwen

Notitie

  • Vanaf .NET 6 genereren nieuwe projecten met behulp 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 moet 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, globaal gebruik van instructies of impliciet gebruik van instructies op te nemen.
  • Zie Nieuwe C#-sjablonen voor meer informatie over het genereren van instructies op het hoogste niveau.
  1. Open het Program.cs-bestand .

  2. Verwijder de bestaande code, inclusief de regel Console.WriteLine("Hello World!"). Kopieer en plak het codevoorbeeld in het Program.cs-bestand 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.

Vertalingsuitvoer:

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 zojuist geleerd om de Translator-service te gebruiken om tekst te vertalen.

Bekijk onze procedures voor documentatie en bekijk de mogelijkheden van vertaalservices: