次の方法で共有

ドキュメント翻訳 SDK

  • [アーティクル]

ドキュメント翻訳は、Azure AI Translator サービスのクラウドベースの REST API 機能です。 ドキュメント翻訳 API を使用すると、サポートされている言語やさまざまなファイル形式で、ドキュメント翻訳全体を非同期的に迅速かつ正確にソースからターゲットにできます。 ドキュメント翻訳ソフトウェア開発キット (SDK) は、ドキュメント翻訳 REST API 機能をアプリケーションに簡単に統合できる一連のライブラリとツールです。

サポートされている言語

ドキュメント翻訳 SDK では、次のプログラミング言語がサポートされています。

言語 → SDK バージョン パッケージ クライアント ライブラリ サポートされている API バージョン
🆕 .NET/C# → 2.0.0-beta.1 NuGet Azure SDK for .NET ドキュメント翻訳 api-version=2024-05-01
🆕 Python → 1.1.0b1 PyPi Azure SDK for Python ドキュメント翻訳 api-version=2024-05-01

変更ログとリリース履歴

このセクションでは、ドキュメント翻訳機能のリリース、変更点、更新、機能強化に関するバージョンベースの説明を提供します。

バージョン 2.0.0-beta.1
2024-05-07

変更ログ/リリース履歴
README
サンプル

アプリケーションでドキュメント翻訳 SDK を使用する

ドキュメント翻訳 SDK を使用すると、アプリケーションでドキュメント翻訳サービスを使用および管理できます。 SDK は、基になるドキュメント翻訳 REST API に基づいて構築されており、プログラミング言語パラダイム内で使用できます。 好みのプログラミング言語を選択します。

1. SDK クライアント ライブラリをインストールする

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. SDK クライアント ライブラリをアプリケーションにインポートする

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

3. クライアントを認証する

Text Translation SDK と対話する DocumentTranslationClient オブジェクトのインスタンスを作成し、続いてそのクライアント オブジェクトのメソッドを呼び出してサービスと対話します。 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(apiKey));

4. アプリをビルドする

非同期バッチ翻訳

ドキュメント翻訳バッチ インターフェイスには、次の入力が必要です。

  1. ファイルを Azure Blob Storage ソース コンテナー (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)

同期単一ドキュメント翻訳

単一ドキュメント翻訳

ヘルプ オプション

開発者コミュニティで Azure Text Translation やその他のサービスに関する質問と回答を行うために、Microsoft Q&A と Stack Overflow フォーラムをご利用いただけます。 Microsoft ではフォーラムを監視しており、コミュニティでまだ回答されていない質問に回答します。

ヒント

Microsoft がお客様の Microsoft Q&A の質問を確実に認識できるように、microsoft-translator のタグを付けてください。 Stack Overflow の質問を確実に認識できるようにするために、Azure AI Translator のタグを付けてください。

次のステップ

ドキュメント翻訳 SDK クイック スタート ドキュメント翻訳 v1.1 REST API リファレンス