Teilen über


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.

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

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. Importieren der SDK-Clientbibliothek in Ihre Anwendung

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

3. Authentifizieren des Clients

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

4. Erstellen Ihrer Anwendung

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

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