Azure Translator は、Azure Translator のクラウドベースの REST API 機能です。 テキスト翻訳 API を使用すると、ソースからターゲットへのテキスト翻訳をリアルタイムで迅速かつ正確に行うことができます。 テキスト翻訳ソフトウェア開発キット (SDK) は、テキスト翻訳 REST API 機能をアプリケーションに簡単に統合できる一連のライブラリとツールです。 テキスト翻訳 SDK は、C#/.NET、Java、JavaScript、Python のプログラミング プラットフォームで使用できます。
サポートされている言語
テキスト翻訳 SDK では、プログラミング言語とプラットフォームがサポートされています。
| 言語 → SDK バージョン | Package | クライアント ライブラリ | サポートされている 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 Translator SDK for Java は、Windows、Linux、および macOS プラットフォームでテストおよびサポートされています。 これは、他のプラットフォームではテストされていません。また、Android のデプロイもサポートされていません。
変更ログとリリース履歴
このセクションでは、テキスト翻訳機能と機能リリース、変更、更新プログラム、および拡張機能のバージョンベースの説明を提供します。
Foundry Tools Text SDK における Azure Translator の 2024年5月(GA) リリース
このリリースには、次の更新プログラムが含まれています。
- バージョン 1.0.0 (2024-05-21)
- ターゲット テキスト翻訳 v3.0
- GA バージョンリリース
Foundry Tools Text SDK の Azure Translator 2023 年 4 月プレビュー リリース
このリリースには、次の更新プログラムが含まれています。
- バージョン 1.0.0-beta.1 (2023-04-17)
- ターゲット テキスト翻訳 v3.0
- 初期バージョンのリリース
アプリケーションでテキスト翻訳 SDK を使用する
テキスト翻訳 SDK を使用すると、アプリケーションでテキスト翻訳サービスを使用および管理できます。 SDK は基になる Text Translation REST API に基づいて構築されており、プログラミング言語パラダイム内でこれらの API を簡単に使用できます。 任意のプログラミング言語にテキスト翻訳 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 との対話は、まず、 TextTranslationClientclass のインスタンスの作成から始まります。 クライアント オブジェクトをインスタンス化するには、API キーとリージョンが必要です。
テキスト変換 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# のテキスト変換サンプル リポジトリを参照してください。
ヘルプ オプション
Microsoft Q & A および Stack Overflow フォーラムは、開発者コミュニティが Azure Translator やその他のサービスに関する質問と回答を行うために利用できます。 Microsoft ではフォーラムを監視しており、コミュニティでまだ回答されていない質問に回答します。 Microsoft が質問を確実に認識できるようにするために、azure-text-translation のタグを付けてください。