文档翻译 SDK

版本 3.0.0

更改日志/版本历史记录

README文件

示例

版本 2.0.0

更改日志/版本历史记录

README文件

示例

版本 1.0.0

更改日志/版本历史记录

README文件

示例

版本 2.0.0

更改日志/版本历史记录

README文件

示例

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;

创建对象实例 DocumentTranslationClient 以与文档翻译 SDK 交互，然后在该客户端对象上调用方法以与服务交互。 DocumentTranslationClient这是使用文档翻译客户端库的主要接口。 它提供同步和异步方法来执行操作。

异步批量翻译

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

同步单文档翻译

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

创建对象实例 DocumentTranslationClient 以与文档翻译 SDK 交互，然后在该客户端对象上调用方法以与服务交互。 DocumentTranslationClient这是使用文档翻译客户端库的主要接口。 它提供同步和异步方法来执行操作。

异步批量翻译

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

client = DocumentTranslationClient(endpoint, AzureKeyCredential(key))

同步单文档翻译

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

client = SingleDocumentTranslationClient(endpoint, AzureKeyCredential(key))

创建用于批量翻译的 DocumentTranslationClient 或用于同步翻译的 SingleDocumentTranslationClient。

异步批量翻译

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

const client = new DocumentTranslationClient(endpoint, credential);

同步单文档翻译

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

const client = new SingleDocumentTranslationClient(endpoint, credential);

创建用于批量翻译的 DocumentTranslationClient 或用于同步翻译的 SingleDocumentTranslationClient。

异步批量翻译

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

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

同步单文档翻译

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

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

异步批量翻译

文档翻译批处理接口需要以下输入：

1. 将文件上传到 Azure Blob 存储源容器 (sourceUri)。
2. 提供可将翻译后的文档写入到的目标容器 (targetUri)。
3. 包括目标语言代码 (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);

同步单文档翻译

单文档翻译

异步批量翻译

文档翻译批处理接口需要以下输入：

1. 将文件上传到 Azure Blob 存储源容器 (sourceUri)。
2. 提供可将翻译后的文档写入到的目标容器 (targetUri)。
3. 包括目标语言代码 (targetLanguage)。

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

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

同步单文档翻译

单文档翻译

异步批量翻译

批量翻译需要源和目标 Azure Blob 存储 容器 URL。 授权配置需要 SAS 令牌时，请在 URL 中包含 SAS 令牌。

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

同步单文档翻译

有关完整示例，请参阅 同步文档翻译。

Java客户端库支持异步批处理翻译和同步单文档翻译。 有关完整示例，请参阅Java示例。