Snabbstart: Azure AI Translator-klientbibliotek för text

I den här snabbstarten kommer du igång med Translator-tjänsten för att översätta text med ett programmeringsspråk som du väljer. För det här projektet rekommenderar vi att du använder den kostnadsfria prisnivån (F0), medan du lär dig tekniken och senare uppgraderar till en betald nivå för produktion.

Förutsättningar

Du behöver 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.

  • Hämta nyckeln, slutpunkten och regionen från resursen och anslut ditt program till Translator-tjänsten. Klistra in dessa värden i koden senare i snabbstarten. Du hittar dem på sidan Azure Portal nycklar och slutpunkt:

    

Konfigurera din C#/.NET-miljö

I den här snabbstarten använder vi den senaste versionen av Visual Studio IDE för att skapa och köra programmet.

1. Starta Visual Studio.

2. På sidan Kom igång väljer du Skapa ett nytt projekt.

   

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

   

4. I dialogrutan Konfigurera det nya projektet anger du text-translation-sdk i rutan Projektnamn. Välj sedan Nästa.

   

5. I dialogrutan Ytterligare information väljer du .NET 6.0 (långsiktigt stöd)och väljer sedan Skapa.

   

Installera klientbiblioteket med NuGet

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

2. Välj fliken Bläddra och kryssrutan Inkludera förhandsversion och skriv Azure.AI.Translation.Text.

   

3. Välj version 1.0.0-beta.1 från den nedrullningsbara menyn och installera paketet i projektet.

   

Skapa ditt program

Om du vill interagera med Translator-tjänsten med hjälp av klientbiblioteket måste du skapa en instans av TextTranslationClientklassen. Det gör du genom att skapa en AzureKeyCredential med din key från Azure Portal och en TextTranslationClient instans med AzureKeyCredential. Autentiseringen varierar något beroende på om resursen använder den regionala eller globala slutpunkten. För det här projektet autentiserar du med hjälp av den globala slutpunkten. Mer information om hur du använder en regional slutpunkt finns i Translator text sdks.

Kommentar

• 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 med hjälp av direktiv.
• Mer information finns i Nya C#-mallar genererar toppnivåinstruktioner.

1. Öppna filen Program.cs .

2. Ta bort den befintliga koden, inklusive raden Console.WriteLine("Hello World!"), och ange följande kodexempel i programmets Program.cs-fil:

Kodexempel

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äkerhet för Azure AI-tjänster.

Översätta text

Kommentar

I det här exemplet använder vi den globala slutpunkten. Om du använder en regional slutpunkt kan du läsa Skapa en textöversättningsklient.

using Azure;
using Azure.AI.Translation.Text;


string key = "<your-key>";

AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential);

try
{
    string targetLanguage = "fr";
    string inputText = "This is a test.";

    Response<IReadOnlyList<TranslatedTextItem>> response = await client.TranslateAsync(targetLanguage, inputText).ConfigureAwait(false);
    IReadOnlyList<TranslatedTextItem> translations = response.Value;
    TranslatedTextItem translation = translations.FirstOrDefault();

    Console.WriteLine($"Detected languages of the input text: {translation?.DetectedLanguage?.Language} with score: {translation?.DetectedLanguage?.Score}.");
    Console.WriteLine($"Text was translated to: '{translation?.Translations?.FirstOrDefault().To}' and the result is: '{translation?.Translations?.FirstOrDefault()?.Text}'.");
}
catch (RequestFailedException exception)
{
    Console.WriteLine($"Error Code: {exception.ErrorCode}");
    Console.WriteLine($"Message: {exception.Message}");
}

Köra ditt program

När du har lagt till kodexemplet i programmet väljer du den gröna Start-knappen bredvid formRecognizer_quickstart för att skapa och köra programmet, eller tryck på F5.

Här är ett kodfragment av förväntade utdata:

Konfigurera din Java-miljö

Kommentar

Azure Text Translation SDK för Java testas och stöds på Windows-, Linux- och macOS-plattformar. Det testas inte på andra plattformar och stöder inte Android-distributioner.

I den här snabbstarten använder vi verktyget Gradle build automation för att skapa och köra programmet.

• Du bör ha den senaste versionen av Visual Studio Code eller önskad IDE. Se Java i Visual Studio Code.

  Dricks

  • Visual Studio Code erbjuder ett kodningspaket för Java för Windows och macOS. Kodningspaketet är ett paket med VS Code, Java Development Kit (JDK) och en samling föreslagna tillägg från Microsoft. Kodningspaketet kan också användas för att åtgärda en befintlig utvecklingsmiljö.
  • Om du använder VS Code och kodningspaketet för Java installerar du Tillägget Gradle for Java .

• Om du inte använder Visual Studio Code kontrollerar du att följande är installerat i utvecklingsmiljön:

  • En Java Development Kit (OpenJDK) version 8 eller senare.

  • Gradle, version 6.8 eller senare.

Skapa ett nytt Gradle-projekt

1. I konsolfönstret (till exempel cmd, PowerShell eller Bash) skapar du en ny katalog för din app med namnet textöversättningsapp och navigerar till den.

   mkdir text-translation-app && text-translation-app
   

   mkdir text-translation-app; cd text-translation-app
   

2. gradle init Kör kommandot från katalogen text-translation-app. Det här kommandot skapar viktiga byggfiler för Gradle, inklusive build.gradle.kts, som används vid körning för att skapa och konfigurera ditt program.

   gradle init --type basic
   

3. Välj en DSL när du uppmanas till det och välj Kotlin.

4. Acceptera standardprojektets namn (textöversättningsapp) genom att välja Retur eller Retur.

   Kommentar

   Det kan ta några minuter innan hela programmet skapas, men snart bör du se flera mappar och filer, inklusive build-gradle.kts.

5. Uppdatera build.gradle.kts med följande kod. Huvudklassen är Translate:

     plugins {
     java
     application
   }
   application {
     mainClass.set("Translate")
   }
   repositories {
     mavenCentral()
   }
   dependencies {
     implementation("com.azure:azure-ai-translation-text:1.0.0-beta.1")
   }
   

Skapa ditt Java-program

1. Kör följande kommando från katalogen textöversättningsapp:

   mkdir -p src/main/java
   

   Kommandot skapar följande katalogstruktur:

   

2. Navigera till java katalogen och skapa en fil med namnet Translate.java.

   Dricks

   • Du kan skapa en ny fil med hjälp av PowerShell.

   • Öppna ett PowerShell-fönster i projektkatalogen genom att hålla ned Skift-tangenten och högerklicka på mappen.

   • Ange följande kommando new-item Translate.java.

   • Du kan också skapa en ny fil i din IDE med namnet Translate.java och spara den i java katalogen.

3. Kopiera och klistra in följande textöversättningskodexempel i din Translate.java-fil .

   • Uppdatera och "<your-endpoint>" "<region>" med värden från din Azure Portal Translator-instans"<your-key>".

Kodexempel

Översätta text

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äkerhet för Azure AI-tjänster.

Om du vill interagera med Translator-tjänsten med hjälp av klientbiblioteket måste du skapa en instans av TextTranslationClientklassen. Det gör du genom att skapa en AzureKeyCredential med din key från Azure Portal och en TextTranslationClient instans med AzureKeyCredential. Autentiseringen varierar något beroende på om resursen använder den regionala eller globala slutpunkten. För det här projektet autentiserar du med hjälp av den globala slutpunkten. Mer information om hur du använder en regional slutpunkt finns i Translator text sdks.

Kommentar

I det här exemplet använder vi den globala slutpunkten. Om du använder en regional slutpunkt kan du läsa Skapa en textöversättningsklient.

import java.util.List;
import java.util.ArrayList;
import com.azure.ai.translation.text.models.*;
import com.azure.ai.translation.text.TextTranslationClientBuilder;
import com.azure.ai.translation.text.TextTranslationClient;

import com.azure.core.credential.AzureKeyCredential;
/**
 * Translate text from known source language to target language.
 */
public class Translate {

    public static void main(String[] args) {
        String apiKey = "<your-key>";
        AzureKeyCredential credential = new AzureKeyCredential(apiKey);

        TextTranslationClient client = new TextTranslationClientBuilder()
                .credential(credential)
                .buildClient();

        String from = "en";
        List<String> targetLanguages = new ArrayList<>();
        targetLanguages.add("es");
        List<InputTextItem> content = new ArrayList<>();
        content.add(new InputTextItem("This is a test."));

        List<TranslatedTextItem> translations = client.translate(targetLanguages, content, null, from, TextType.PLAIN, null, null, null, false, false, null, null, null, false);

        for (TranslatedTextItem translation : translations) {
            for (Translation textTranslation : translation.getTranslations()) {
                System.out.println("Text was translated to: '" + textTranslation.getTo() + "' and the result is: '" + textTranslation.getText() + "'.");
            }
        }
    }
}

Skapa och kör programmet**

När du har lagt till kodexemplet i ditt program går du tillbaka till huvudprojektkatalogen – textöversättningsapp.

1. Skapa ditt program med build kommandot (du bör få ett BUILD SUCCESSFUL-meddelande ):

   gradle build
   

2. Kör programmet med run kommandot (du bör få ett BUILD SUCCESSFUL-meddelande ):

   gradle run
   

Här är ett kodfragment av förväntade utdata:

Konfigurera din Node.js miljö

I den här snabbstarten använder vi Node.js JavaScript-körningsmiljö för att skapa och köra programmet.

1. Om du inte redan har gjort det installerar du den senaste versionen av Node.js. Node Package Manager (npm) ingår i installationen av Node.js.

   Dricks

   Om du inte har Node.js kan du prova modulen Introduktion till Node.js Learn.

2. I ett konsolfönster (till exempel cmd, PowerShell eller Bash) skapar och navigerar du till en ny katalog för din app med namnet text-translation-app.

   mkdir text-translation-app && cd text-translation-app
   

   mkdir text-translation-app; cd text-translation-app
   

3. Kör kommandot npm init för att initiera programmet och skapa en autogenerering av projektet.

   npm init
   

4. Ange projektets attribut genom att acceptera de prompter som visas i terminalen.

   • De viktigaste attributen är namn, versionsnummer och startpunkt.
   • Vi rekommenderar att du behåller index.js namnet på startpunkten. Beskrivningen, testkommandot, GitHub-lagringsplatsen, nyckelord, författare och licensinformation är valfria attribut – de kan hoppas över för det här projektet.
   • Acceptera förslagen inom parenteser genom att välja Retur eller Retur.
   • När du har slutfört anvisningarna skapas en package.json fil i katalogen textöversättningsapp.

Installera klientbiblioteket

Öppna ett terminalfönster och installera Azure Text Translation klientbiblioteket för JavaScript med npm:

npm i @azure-rest/ai-translation-text@1.0.0-beta.1

Skapa ditt program

Om du vill interagera med Translator-tjänsten med hjälp av klientbiblioteket måste du skapa en instans av TextTranslationClientklassen. För att göra det skapar du en TranslateCredential med din key och <region> från Azure Portal och en TextTranslationClient instans. Mer information finns i Translator text sdks.

1. index.js Skapa filen i appkatalogen.

   Dricks

   • Du kan skapa en ny fil med hjälp av PowerShell.

   • Öppna ett PowerShell-fönster i projektkatalogen genom att hålla ned Skift-tangenten och högerklicka på mappen.

   • Ange följande kommando New-Item index.js.

   • Du kan också skapa en ny fil med namnet index.js i din IDE och spara den i text-translation-app katalogen.

2. Kopiera och klistra in följande textöversättningskodexempel i index.js filen. Uppdatera <your-endpoint> och <your-key> med värden från din Azure Portal Translator-instans.

Kodexempel

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äkerhet för Azure AI-tjänster.

Översätta text

Kommentar

I det här exemplet använder vi en regional slutpunkt. Om du använder den globala slutpunkten kan du läsa Skapa en textöversättningsklient.

const TextTranslationClient = require("@azure-rest/ai-translation-text").default

const apiKey = "<your-key>";
const endpoint = "<your-endpoint>";
const region = "<region>";

async function main() {

  console.log("== Text translation sample ==");

  const translateCredential = {
    key: apiKey,
    region,
  };
  const translationClient = new TextTranslationClient(endpoint,translateCredential);

  const inputText = [{ text: "This is a test." }];
  const translateResponse = await translationClient.path("/translate").post({
    body: inputText,
    queryParameters: {
      to: "fr",
      from: "en",
    },
  });

  const translations = translateResponse.body;
  for (const translation of translations) {
    console.log(
      `Text was translated to: '${translation?.translations[0]?.to}' and the result is: '${translation?.translations[0]?.text}'.`
    );
  }
}

main().catch((err) => {
    console.error("An error occurred:", err);
    process.exit(1);
  });

  module.exports = { main };

Köra ditt program

När du har lagt till kodexemplet i programmet kör du programmet:

1. Navigera till mappen där du har ditt textöversättningsprogram (textöversättningsapp).

2. Skriv följande kommando i terminalen:

   node index.js
   

Här är ett kodfragment av förväntade utdata:

Konfigurera ditt Python-projekt

1. Om du inte redan har gjort det installerar du den senaste versionen av Python 3.x. Python Installer-paketet (pip) ingår i Python-installationen.

   Dricks

   Om du inte har använt Python tidigare kan du prova modulen Introduktion till Python Learn.

2. Öppna ett terminalfönster och installera Azure Text Translation klientbiblioteket för Python med pip:

   pip install azure-ai-translation-text==1.0.0b1
   

Skapa ditt program

Om du vill interagera med Translator-tjänsten med hjälp av klientbiblioteket måste du skapa en instans av TextTranslationClientklassen. För att göra det skapar du en TranslatorCredential med din key från Azure Portal och en TextTranslationClient instans. Mer information finns i Translator text sdks.

1. Skapa en ny Python-fil med namnet text-translation-app.py i önskad redigerare eller IDE.

2. Kopiera och klistra in följande kodexempel för textöversättning i text-translation-app.py-filen. Uppdatera <your-key>, <your-endpoint>och <region> med värden från din Azure Portal Translator-instans.

Kodexempel

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äkerhet för Azure AI-tjänster.

Översätta text

Kommentar

I det här exemplet använder vi en regional slutpunkt. Om du använder den globala slutpunkten kan du läsa Skapa en textöversättningsklient.

from azure.ai.translation.text import TextTranslationClient, TranslatorCredential
from azure.ai.translation.text.models import InputTextItem
from azure.core.exceptions import HttpResponseError

# set `<your-key>`, `<your-endpoint>`, and  `<region>` variables with the values from the Azure portal
key = "<your-key>"
endpoint = "<your-endpoint>"
region = "<region>"

credential = TranslatorCredential(key, region)
text_translator = TextTranslationClient(endpoint=endpoint, credential=credential)

try:
    source_language = "en"
    target_languages = ["es", "it"]
    input_text_elements = [ InputTextItem(text = "This is a test") ]

    response = text_translator.translate(content = input_text_elements, to = target_languages, from_parameter = source_language)
    translation = response[0] if response else None

    if translation:
        for translated_text in translation.translations:
            print(f"Text was translated to: '{translated_text.to}' and the result is: '{translated_text.text}'.")

except HttpResponseError as exception:
    print(f"Error Code: {exception.error.code}")
    print(f"Message: {exception.error.message}")

Kör appen

När du har lagt till kodexemplet i ditt program skapar och kör du programmet:

Gå till mappen där du har din text-translation-app.py-fil .

Skriv följande kommando i terminalen:

python text-translation-app.py

Här är ett kodfragment av förväntade utdata:

Det var allt, grattis! I den här snabbstarten använde du en SDK för textöversättning för att översätta text.

Nästa steg

Läs mer om utvecklingsalternativ för textöversättning:

SDK för textöversättning – översikt

över V3-referens för textöversättning