Azure Text Translation SDK
Azure Text Translation は、Azure AI Translator サービスのクラウドベースの REST API 機能です。 Text Translation API を使用すると、ソースからターゲットへのテキスト翻訳をリアルタイムで迅速かつ正確に行えます。 Text Translation ソフトウェア開発キット (SDK) は、Text Translation REST API 機能をアプリケーションに簡単に統合できる一連のライブラリとツールです。 テキスト翻訳 SDK は、C#/.NET、Java、JavaScript、Python のプログラミング プラットフォームで使用できます。
サポートされている言語
Text Translation SDK では、次のプログラミング言語とプラットフォームがサポートされています。
| 言語 → SDK バージョン | パッケージ | クライアント ライブラリ | サポートされている API バージョン |
|---|---|---|---|
| .NET/C# → 1.0.0 | NuGet | Azure SDK for .NET | Translator v3.0 |
| Java✱ → 1.0.0 | Maven リポジトリ | Azure SDK for Java | Translator v3.0 |
| JavaScript → 1.0.0 | npm | Azure SDK for JavaScript | Translator v3.0 |
| Python → 1.0.1 | PyPi | Azure SDK for Python | Translator v3.0 |
✱ Azure Text Translation SDK for Java は、Windows、Linux、macOS プラットフォームでテストおよびサポートされています。 これは、他のプラットフォームではテストされていません。また、Android のデプロイもサポートされていません。
変更ログとリリース履歴
このセクションでは、Text Translation 機能のリリース、変更点、更新、機能強化に関するバージョンベースの説明を提供します。
2024 年 5 月の Translator Text SDK の GA リリース
このリリースには、次の更新プログラムが含まれています。
- バージョン 1.0.0 (2024-05-21)
- ターゲット テキスト翻訳 v3.0
- GA バージョンのリリース
Translator Text SDK 2023 年 4 月のプレビュー リリース
このリリースには、次の更新プログラムが含まれています。
- バージョン 1.0.0-beta.1 (2023-04-17)
- ターゲット テキスト翻訳 v3.0
- 初期バージョンのリリース
アプリケーションで Text Translation SDK を使用する
Text Translation SDK を使用すると、アプリケーションで Text Translation サービスを使用および管理できます。 SDK は、基になる Text Translation REST API に基づいて構築されており、プログラミング言語パラダイム内でこれらの API を簡単に使用できます。 ここでは、ご希望のプログラミング言語で Text Translation SDK を使用する方法について説明します。
1. SDK クライアント ライブラリをインストールする
dotnet add package Azure.AI.Translation.Text --version 1.0.0-beta.1
Install-Package Azure.AI.Translation.Text -Version 1.0.0-beta.1
2. SDK クライアント ライブラリをアプリケーションにインポートする
using Azure;
using Azure.AI.Translation.Text;
3. クライアントを認証する
クライアント ライブラリを使用して Translator サービスと連携するには、TextTranslationClient クラスのインスタンスを作成することから始まります。 クライアント オブジェクトをインスタンス化するには、API キーとリージョンが必要です。
Text Translation API キーは、Azure portal にあります。
グローバル エンドポイントを使用する (デフォルト)
string key = "<your-key>";
AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential);
リージョン エンドポイントの使用
Uri endpoint = new("<your-endpoint>");
string key = "<your-key>";
string region = "<region>";
AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential, region);
4. アプリをビルドする
Text Translation SDK と対話するクライアント オブジェクトを作成し、続いてそのクライアント オブジェクトのメソッドを呼び出してサービスと対話します。 SDK には同期メソッドと非同期メソッドの両方が用意されています。 詳細については、.NET/C# のテキスト翻訳サンプル リポジトリを参照してください。
ヘルプ オプション
開発者コミュニティで Azure Text Translation やその他のサービスに関する質問と回答を行うために、Microsoft Q & A と Stack Overflow フォーラムをご利用いただけます。 Microsoft ではフォーラムを監視しており、コミュニティでまだ回答されていない質問に回答します。 Microsoft が質問を確実に認識できるようにするために、azure-text-translation のタグを付けてください。