Dokumentübersetzungs-SDKs

Dokumentübersetzung ist ein cloudbasiertes REST-API-Feature des Azure KI Übersetzer-Diensts. Die Dokumentübersetzungs-API ermöglicht asynchron schnelle und genaue Quelle-zu-Ziel-Übersetzungen ganzer Dokumente in unterstützten Sprachen und verschiedenen Dateiformaten. Das Dokumentübersetzung-SDK (Software Development Kit) besteht aus einer Reihe von Bibliotheken und Tools, mit denen Sie die Funktionen der Dokumentübersetzungs-REST-API einfach in Ihre Anwendungen integrieren können.

Unterstützte Sprachen

Das Dokumentübersetzungs-SDK unterstützt die folgenden Programmiersprachen:

Sprache → SDK-Version	Paket	Clientbibliothek	Unterstützte API-Version
🆕 .NET/C# → 2.0.0-beta.1	NuGet	Azure SDK für .NET	Dokumentübersetzung api-version=2024-05-01
🆕 Python → 1.1.0b1	PyPi	Azure-SDK für Python	Dokumentübersetzung api-version=2024-05-01

Änderungsprotokoll und Releaseverlauf

Dieser Abschnitt enthält eine versionsbasierte Beschreibung der Releases, Änderungen, Aktualisierungen und Erweiterungen des Dokumentübersetzungsfeatures und seiner Funktionen.

C#/.NET

Version 2.0.0-beta.1
2024-05-07

Änderungsprotokoll/Releaseverlauf

Infodatei

Beispiele

Python

Version 1.1.0b1
2024-05-07

Änderungsprotokoll/Releaseverlauf

Infodatei

Beispiele

Verwenden des Dokumentübersetzungs-SDKs in Ihren Anwendungen

Das Dokumentübersetzungs-SDK ermöglicht die Verwendung und Verwaltung des Translation-Diensts in Ihrer Anwendung. Das SDK basiert auf der zugrunde liegenden Dokumentübersetzungs-REST-API zur Verwendung in Ihrem Programmiersprachenparadigma. Wählen Sie Ihre bevorzugte Programmiersprache:

1. Installieren der SDK-Clientbibliothek

C#/.NET

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

Python

pip install azure-ai-translation-document==1.1.0b1

2. Importieren der SDK-Clientbibliothek in Ihre Anwendung

C#/.NET

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

Python

from azure.ai.translation.document import DocumentTranslationClient
from azure.core.credentials import AzureKeyCredential

3. Authentifizieren des Clients

C#/.NET

Erstellen Sie eine Instanz des „DocumentTranslationClient“-Objekts, um mit dem Dokumentübersetzungs-SDK zu interagieren. Rufen Sie dann Methoden auf diesem Clientobjekt auf, um mit dem Dienst zu kommunizieren. Die DocumentTranslationClient ist die primäre Schnittstelle für die Verwendung der Clientbibliothek für die Dokumentübersetzung. Sie bietet sowohl synchrone als auch asynchrone Methoden zum Ausführen von Vorgängen.

Asynchrone Batchübersetzung

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

Synchrone Einzeldokumentübersetzung

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

Python

Erstellen Sie eine Instanz des „DocumentTranslationClient“-Objekts, um mit dem Dokumentübersetzungs-SDK zu interagieren. Rufen Sie dann Methoden auf diesem Clientobjekt auf, um mit dem Dienst zu kommunizieren. Die DocumentTranslationClient ist die primäre Schnittstelle für die Verwendung der Clientbibliothek für die Dokumentübersetzung. Sie bietet sowohl synchrone als auch asynchrone Methoden zum Ausführen von Vorgängen.

Asynchrone Batchübersetzung

  endpoint = "<endpoint>"
  key = "<apiKey>"

  client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))

Synchrone Einzeldokumentübersetzung

  endpoint = "<endpoint>"
  key = "<apiKey>"

  client = SingleDocumentTranslationClient(endpoint, AzureKeyCredential(key))

4. Erstellen Ihrer Anwendung

C#/.NET

Asynchrone Batchübersetzung

Für die Schnittstellen für die Dokumentübersetzung im Batch sind folgende Eingaben erforderlich:

1. Laden Sie Ihre Dateien in einen Azure Blob Storage-Quellcontainer (sourceUri) hoch.
2. Stellen Sie einen Zielcontainer bereit, in den die übersetzten Dokumente geschrieben werden können (targetUri).
3. Fügen Sie den Zielsprachencode (targetLanguage) ein.

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)

Synchrone Einzeldokumentübersetzung

Einzeldokumentübersetzung

Python

Asynchrone Batchübersetzung

Für die Schnittstellen für die Dokumentübersetzung im Batch sind folgende Eingaben erforderlich:

1. Laden Sie Ihre Dateien in einen Azure Blob Storage-Quellcontainer (sourceUri) hoch.
2. Stellen Sie einen Zielcontainer bereit, in den die übersetzten Dokumente geschrieben werden können (targetUri).
3. Fügen Sie den Zielsprachencode (targetLanguage) ein.

sourceUrl = "<your-source container-url>"
targetUrl = "<your-target-container-url>"
targetLanguage = "<target-language-code>"

poller = client.begin_translation(sourceUrl, targetUrl, targetLanguage)
result = poller.result()

Synchrone Einzeldokumentübersetzung

Einzeldokumentübersetzung

Hilfeoptionen

In den Foren von Microsoft Q&A und Stack Overflow können Entwickelnde Fragen zur Azure Text Translation und zu anderen Diensten stellen und beantworten. Microsoft verfolgt die Foren und antwortet auf Fragen, die von der Community noch beantwortet werden müssen.

Tipp

Um sicherzustellen, dass wir Ihre Microsoft Q&A-Frage sehen können, taggen Sie sie mit microsoft-translator. Um sicherzustellen, dass wir Ihre Stack Overflow-Frage sehen können, taggen Sie sie mit Azure AI Translator.

Nächste Schritte

Schnellstart: SDK für die DokumentübersetzungReferenz zur REST-API für die Dokumentübersetzung v1.1