Dela via

SDK:er för dokumentöversättning

  • Artikel

Dokumentöversättning är en molnbaserad REST API-funktion i Azure AI Translator-tjänsten. API:et för dokumentöversättning möjliggör snabba och korrekta käll-till-mål-hela dokumentöversättningar, asynkront, i språk som stöds och olika filformat. SDK (Document Translation Software Development Kit) är en uppsättning bibliotek och verktyg som gör att du enkelt kan integrera REST API-funktioner för dokumentöversättning i dina program.

Språk som stöds

SDK för dokumentöversättning stöder följande programmeringsspråk:

Language → SDK-version Paket Klientbibliotek API-version som stöds
🆕 .NET/C# → 2.0.0-beta.1 NuGet Azure SDK för .NET Dokumentöversättning api-version=2024-05-01
🆕 Python → 1.1.0b1 PyPi Azure SDK för Python Dokumentöversättning api-version=2024-05-01

Ändringslogg och versionshistorik

Det här avsnittet innehåller en versionsbaserad beskrivning av funktioner och versioner av dokumentöversättning, ändringar, uppdateringar och förbättringar.

Använda SDK för dokumentöversättning i dina program

Med SDK:et för dokumentöversättning kan du använda och hantera översättningstjänsten i ditt program. SDK bygger på underliggande REST API:er för dokumentöversättning för användning inom programmeringsspråkparadigmet. Välj önskat programmeringsspråk:

1. Installera SDK-klientbiblioteket

dotnet add package Azure.AI.Translation.Document --version 2.0.0-beta.1

Install-Package Azure.AI.Translation.Document -Version 2.0.0-beta.1

2. Importera SDK-klientbiblioteket till ditt program

using System;
using Azure.Core;
using Azure.AI.Translation.Document;

3. Autentisera klienten

Skapa en instans av DocumentTranslationClient objektet för att interagera med SDK:t för dokumentöversättning och anropa sedan metoder på klientobjektet för att interagera med tjänsten. DocumentTranslationClient är det primära gränssnittet för att använda klientbiblioteket för dokumentöversättning. Den innehåller både synkrona och asynkrona metoder för att utföra åtgärder.

Asynkron batchöversättning

private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";

DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));

Synkron översättning av enkla dokument

private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";

SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));

4. Skapa ditt program

Asynkron batchöversättning

Batchgränssnitt för dokumentöversättning kräver följande indata:

  1. Ladda upp dina filer till en Azure Blob Storage-källcontainer (sourceUri).
  2. Ange en målcontainer där de översatta dokumenten kan skrivas (targetUri).
  3. Inkludera målspråkkoden (targetLanguage).

Uri sourceUri = new Uri("<your-source container-url");
Uri targetUri = new Uri("<your-target-container-url>");
string targetLanguage = "<target-language-code>";

DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage)

Synkron översättning av enkla dokument

Översättning av enkla dokument

Hjälpalternativ

Forumen Microsoft Q&A och Stack Overflow är tillgängliga för utvecklarcommunityn för att ställa och svara på frågor om Azure Text Translation och andra tjänster. Microsoft övervakar forumen och svarar på frågor som communityn ännu inte har besvarat.

Dricks

Se till att du ser din Microsoft-fråga Q&A genom att tagga den med microsoft-translator. Se till att du ser din Stack Overflow-fråga genom att tagga den med Azure AI Translator.

Nästa steg

SDK-snabbstart för dokumentöversättning v1.1 REST API-referens