Dokumentübersetzungs-SDKs

Version 3.0.0

Änderungsprotokoll/Releaseverlauf

INFODATEI

Beispiele

Version 2.0.0

Änderungsprotokoll/Releaseverlauf

INFODATEI

Beispiele

Version 1.0.0

Änderungsprotokoll/Releaseverlauf

INFODATEI

Beispiele

Version 2.0.0

Änderungsprotokoll/Releaseverlauf

INFODATEI

Beispiele

dotnet add package Azure.AI.Translation.Document --version 3.0.0

Install-Package Azure.AI.Translation.Document -Version 3.0.0

pip install azure-ai-translation-document==2.0.0

npm install @azure/ai-translation-document@1.0.0

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-ai-translation-document</artifactId>
  <version>2.0.0</version>
</dependency>

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

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

import {
  DocumentTranslationClient,
  SingleDocumentTranslationClient,
} from "@azure/ai-translation-document";
import type { KeyCredential } from "@azure/core-auth";

import com.azure.ai.translation.document.DocumentTranslationClient;
import com.azure.ai.translation.document.DocumentTranslationClientBuilder;
import com.azure.ai.translation.document.SingleDocumentTranslationClient;
import com.azure.ai.translation.document.SingleDocumentTranslationClientBuilder;
import com.azure.core.credential.AzureKeyCredential;

Erstellen Sie eine Instanz des DocumentTranslationClient Objekts, um mit dem Dokumentübersetzungs-SDK zu interagieren, und rufen Sie dann Methoden für dieses Clientobjekt auf, um mit dem Dienst zu interagieren. 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(key));

Erstellen Sie eine Instanz des DocumentTranslationClient Objekts, um mit dem Dokumentübersetzungs-SDK zu interagieren, und rufen Sie dann Methoden für dieses Clientobjekt auf, um mit dem Dienst zu interagieren. 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 = "<api-key>"

client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))

Synchrone Einzeldokumentübersetzung

endpoint = "<endpoint>"
key = "<api-key>"

client = SingleDocumentTranslationClient(endpoint, AzureKeyCredential(key))

Erstellen Sie eine DocumentTranslationClient Batchübersetzung oder eine SingleDocumentTranslationClient für synchrone Übersetzung.

Asynchrone Batchübersetzung

const endpoint = "<endpoint>";
const credential: KeyCredential = { key: "<api-key>" };

const client = new DocumentTranslationClient(endpoint, credential);

Synchrone Einzeldokumentübersetzung

const endpoint = "<endpoint>";
const credential: KeyCredential = { key: "<api-key>" };

const client = new SingleDocumentTranslationClient(endpoint, credential);

Erstellen Sie eine DocumentTranslationClient Batchübersetzung oder eine SingleDocumentTranslationClient für synchrone Übersetzung.

Asynchrone Batchübersetzung

String endpoint = "<endpoint>";
String key = "<api-key>";

DocumentTranslationClient client = new DocumentTranslationClientBuilder()
    .endpoint(endpoint)
    .credential(new AzureKeyCredential(key))
    .buildClient();

Synchrone Einzeldokumentübersetzung

String endpoint = "<endpoint>";
String key = "<api-key>";

SingleDocumentTranslationClient client =
    new SingleDocumentTranslationClientBuilder()
        .endpoint(endpoint)
        .credential(new AzureKeyCredential(key))
        .buildClient();

Asynchrone Batchübersetzung

Schnittstellen für Dokument-Übersetzungs-Batches erfordern folgende Eingaben:

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

Asynchrone Batchübersetzung

Schnittstellen für Dokument-Übersetzungs-Batches erfordern folgende Eingaben:

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

Asynchrone Batchübersetzung

Für die Batchübersetzung sind Quell- und Ziel-Azure Blob Storage Container-URLs erforderlich. Schließen Sie SAS-Token in die URLs ein, wenn ihre Autorisierungskonfiguration sie erfordert.

const poller = client.startTranslation({
  inputs: [
    {
      source: { sourceUrl: "<source-container-url>" },
      targets: [
        {
          targetUrl: "<target-container-url>",
          language: "<target-language-code>",
        },
      ],
    },
  ],
});

const result = await poller.pollUntilDone();
console.log(`Translation status: ${result.status}`);

Synchrone Einzeldokumentübersetzung

Ein vollständiges Beispiel finden Sie unter Synchrone Dokumentübersetzung.

Die Java-Clientbibliothek unterstützt asynchrone Batchübersetzung und synchrone Einzeldokumentübersetzung. Vollständige Beispiele finden Sie in den Java Beispielen.