Snabbstart: Azure Cognitive Services Translator

I den här snabbstarten kommer du igång med Translator-tjänsten för att översätta text med valfritt programmeringsspråk och REST-API:et.

Anteckning

  • I den här snabbstarten rekommenderar vi att du använder en global translator-textresurs med en tjänst.
  • Med en global resurs med en tjänst inkluderar du ett auktoriseringshuvud (Ocp-Apim-Subscription-key) med REST API-begäran. Värdet för Ocp-Apim-Subscription-key är din Hemliga Azure-nyckel för din Translator Text-prenumeration.
  • Om du väljer att använda Cognitive Services med flera tjänster eller en regional Translator-resurs krävs två autentiseringshuvuden: (Ocp-Api-Subscription-Key och Ocp-Apim-Subscription-Region). Värdet för Ocp-Apim-Subscription-Region är den region som är associerad med din prenumeration.
  • Mer information om hur du använder huvudet Ocp-Apim-Subscription-Region finns iText Translator REST API-huvuden.

Förutsättningar

För att komma igång behöver du en aktiv Azure-prenumeration. Om du inte har en Azure-prenumeration kan du skapa en kostnadsfritt

  • När du har din Azure-prenumeration skapar du en Translator-resurs i Azure Portal.

  • När resursen har distribuerats väljer du Gå till resurs och hämtar nyckeln och slutpunkten.

    • Du behöver nyckeln och slutpunkten från resursen för att ansluta ditt program till Translator-tjänsten. Du klistrar in nyckeln och slutpunkten i koden senare i snabbstarten. Du hittar dessa värden på sidan Azure Portal nycklar och slutpunkt:

      Skärmbild: Azure Portal nycklar och slutpunktssida.

  • Använd den kostnadsfria prisnivån (F0) för att prova tjänsten och uppgradera senare till en betald nivå för produktion.

Sidhuvuden

Om du vill anropa Translator-tjänsten via REST-API:et måste du inkludera följande huvuden i varje begäran. Oroa dig inte, vi tar med rubrikerna åt dig i exempelkoden för varje programmeringsspråk.

Mer information om alternativ för Translator-autentisering finns ireferensguiden för Translator v3 .

Huvud Värde Villkor
Ocp-Apim-Subscription-Key Din Translator-tjänstnyckel från Azure Portal. Krävs
Ocp-Apim-Subscription-Region Den region där resursen skapades. Krävs när du använder en Cognitive Services-resurs med flera tjänster eller en regional resurs (icke-global).
Valfritt när du använder en global Translator Resource med en enda tjänst.
Innehållstyp Nyttolastens innehållstyp. Det godkända värdet är application/json eller charset=UTF-8. Krävs
Innehållslängd Längden på begärandetexten. Valfritt

Viktigt

Kom ihåg att ta bort nyckeln från koden när du är klar och publicera den aldrig offentligt. För produktion använder du ett säkert sätt att lagra och komma åt dina autentiseringsuppgifter som Azure Key Vault. Mer information finns i säkerhetsartikeln för Cognitive Services.

Översätt text

Translator-tjänstens kärnåtgärd är översättning av text. I den här snabbstarten skapar du en begäran med ett valfritt programmeringsspråk som tar en enda källa (from) och ger två utdata (to). Sedan granskar vi några parametrar som kan användas för att justera både begäran och svaret.

Konfigurera ditt Visual Studio-projekt

  1. Kontrollera att du har den aktuella versionen av Visual Studio IDE.

    Tips

    Om Visual Studio är nytt för dig kan du prova learn-modulen Introduktion till Visual Studio .

  2. Öppna Visual Studio.

  3. På sidan Start väljer du Skapa ett nytt projekt.

    Skärmbild: Startfönstret i Visual Studio.

  4. sidan Skapa ett nytt projekt anger du konsolen i sökrutan. Välj mallen Konsolprogram och välj sedan Nästa.

    Skärmbild: Sidan Skapa nytt projekt i Visual Studio.

  5. I dialogrutan Konfigurera det nya projektet anger du translator_quickstart i rutan Projektnamn. Låt kryssrutan "Placera lösning och projekt i samma katalog" vara avmarkerad och välj Nästa.

    Skärmbild: Dialogrutan Konfigurera nytt projekt i Visual Studio.

  6. I dialogrutan Ytterligare information kontrollerar du att .NET 6.0 (långsiktigt stöd) har valts. Låt kryssrutan "Använd inte toppnivåinstruktioner" vara avmarkerad och välj Skapa.

    Skärmbild: Dialogrutan För ytterligare information i Visual Studio.

Installera Newtonsoft.json-paketet med NuGet

  1. Högerklicka på ditt translator_quickstart projekt och välj Hantera NuGet-paket... .

    Skärmbild av sökrutan för NuGet-paketet.

  2. Välj fliken Bläddra och skriv Newtonsoft.json.

    Skärmbild av installationsfönstret för NuGet-paketet.

  3. Välj installera från rätt pakethanterarfönster för att lägga till paketet i projektet.

    Skärmbild av installationsknappen för NuGet-paketet.

Skapa ditt C#-program

Anteckning

  • Från och med .NET 6 genererar nya projekt med mallen console ett nytt programformat som skiljer sig från tidigare versioner.
  • De nya utdata använder de senaste C#-funktionerna som förenklar koden du behöver skriva.
  • När du använder den nyare versionen behöver du bara skriva metodens Main brödtext. Du behöver inte inkludera toppnivåinstruktioner, globala användningsdirektiv eller implicita användningsdirektiv.
  • Mer information finns iNya C#-mallar genererar instruktioner på den översta nivån.
  1. Öppna filen Program.cs .

  2. Ta bort den befintliga koden, inklusive raden Console.Writeline("Hello World!"). Kopiera och klistra in kodexemplet i programmets Program.cs-fil. Se till att du uppdaterar nyckelvariabeln med värdet från din Azure Portal Translator-instans:

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

Köra C#-programmet

När du har lagt till ett kodexempel i programmet väljer du den gröna startknappen bredvid formRecognizer_quickstart för att skapa och köra programmet eller trycker på F5.

Skärmbild av knappen Kör program i Visual Studio.

Översättningsutdata:

Efter ett lyckat anrop bör du se följande svar:

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

Nästa steg

Det var allt, grattis! Du har lärt dig att använda Translator-tjänsten för att översätta text.

Utforska vår dokumentation om instruktioner och ta en djupare titt på funktionerna i översättningstjänsten: