Azure Text Translation SDK (プレビュー)

重要

• Translator テキスト SDK は現在、パブリック プレビューで利用できます。 機能、アプローチ、およびプロセスは、一般提供 (GA) の前に、ユーザーからのフィードバックに基づいて変更される可能性があります。

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-beta.1	NuGet	Azure SDK for .NET	Translator v3.0
Java✱ → 1.0.0-beta.1	Maven リポジトリ	Azure SDK for Java	Translator v3.0
JavaScript → 1.0.0-beta.1	npm	Azure SDK for JavaScript	Translator v3.0
Python → 1.0.0b1	PyPi	Azure SDK for Python	Translator v3.0

✱ Azure Text Translation SDK for Java は、Windows、Linux、macOS プラットフォームでテストおよびサポートされています。 これは、他のプラットフォームではテストされていません。また、Android のデプロイもサポートされていません。

変更ログとリリース履歴

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

Translator Text SDK 2023 年 4 月のプレビュー リリース

このリリースには、次の更新プログラムが含まれています。

C#

• バージョン 1.0.0-beta.1 (2023-04-17)
• ターゲット テキスト翻訳 v3.0
• 初期バージョンのリリース

パッケージ (NuGet)

変更ログ/リリース履歴

README

サンプル

Java

• バージョン 1.0.0-beta.1 (2023-04-18)
• ターゲット テキスト翻訳 v3.0
• 初期バージョンのリリース

パッケージ (MVN)

変更ログ/リリース履歴

README

サンプル

JavaScript

• バージョン 1.0.0-beta.1 (2023-04-18)
• ターゲット テキスト翻訳 v3.0
• 初期バージョンのリリース

パッケージ (npm)

変更ログ/リリース履歴

README

サンプル

Python

• バージョン 1.0.0b1 (2023-04-19)
• ターゲット テキスト翻訳 v3.0
• 初期バージョンのリリース

パッケージ (PyPi)

変更ログ/リリース履歴

README

サンプル

アプリケーションで Text Translation SDK を使用する

Text Translation SDK を使用すると、アプリケーションで Text Translation サービスを使用および管理できます。 SDK は、基になる Text Translation REST API に基づいて構築されており、プログラミング言語パラダイム内でこれらの API を簡単に使用できます。 ここでは、ご希望のプログラミング言語で Text Translation SDK を使用する方法について説明します。

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

C#/.NET

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

Java

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-ai-translation-text</artifactId>
    <version>1.0.0-beta.1</version>
</dependency>

implementation("com.azure:azure-ai-translation-text:1.0.0-beta.1")

JavaScript

npm i @azure-rest/ai-translation-text@1.0.0-beta.1

Python

pip install azure-ai-translation-text==1.0.0b1

2. SDK クライアント ライブラリをアプリケーションにインポートする

C#/.NET

using Azure;
using Azure.AI.Translation.Text;

Java

import java.util.List;
import java.util.ArrayList;
import com.azure.ai.translation.text.models.*;
import com.azure.ai.translation.text.TextTranslationClientBuilder;
import com.azure.ai.translation.text.TextTranslationClient;

import com.azure.core.credential.AzureKeyCredential;

JavaScript

const {TextTranslationClient } = require("@azure-rest/ai-translation-text").default;

Python

from azure.core.credentials import TextTranslationClient
from azure-ai-translation-text import TextTranslationClient

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

クライアント ライブラリを使用して Translator サービスと連携するには、TextTranslationClient クラスのインスタンスを作成することから始まります。 クライアント オブジェクトをインスタンス化するには、API キーとリージョンが必要です。 Text Translation API キーは、Azure portal にあります。

C#/.NET

グローバル エンドポイントを使用する (デフォルト)

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

Java

グローバル エンドポイントを使用する (デフォルト)

String apiKey = "<your-key>";
AzureKeyCredential credential = new AzureKeyCredential(apiKey);

TextTranslationClient client = new TextTranslationClientBuilder()
            .credential(credential)
            .buildClient();

リージョン エンドポイントの使用

String apiKey = "<your-key>";
String endpoint = "<your-endpoint>";
String region = "<region>";

AzureKeyCredential credential = new AzureKeyCredential(apiKey);

TextTranslationClient client = new TextTranslationClientBuilder()
.credential(credential)
.region(region)
.endpoint(endpoint)
.buildClient();

JavaScript

const TextTranslationClient = require("@azure-rest/ai-translation-text").default,

const apiKey = "<your-key>";
const endpoint = "<your-endpoint>";
const region = "<region>";

Python

from azure.ai.translation.text import TextTranslationClient, TranslatorCredential
from azure.ai.translation.text.models import InputTextItem
from azure.core.exceptions import HttpResponseError

key = "<your-key>"
endpoint = "<your-endpoint>"
region = "<region>"


credential = TranslatorCredential(key, region)
text_translator = TextTranslationClient(endpoint=endpoint, credential=credential)

4. アプリをビルドする

C#/.NET

Text Translation SDK と対話するクライアント オブジェクトを作成し、続いてそのクライアント オブジェクトのメソッドを呼び出してサービスと対話します。 SDK には同期メソッドと非同期メソッドの両方が用意されています。 詳細については、.NET/C# のテキスト翻訳サンプル リポジトリを参照してください。

Java

Text Translation SDK と対話するクライアント オブジェクトを作成し、続いてそのクライアント オブジェクトのメソッドを呼び出してサービスと対話します。 SDK には同期メソッドと非同期メソッドの両方が用意されています。 詳細については、Java のテキスト翻訳サンプル リポジトリを参照してください。

JavaScript

Text Translation SDK と対話するクライアント オブジェクトを作成し、続いてそのクライアント オブジェクトのメソッドを呼び出してサービスと対話します。 SDK には同期メソッドと非同期メソッドの両方が用意されています。 詳細については、JavaScript または TypeScript のテキスト翻訳サンプル リポジトリを参照してください。

Python

Text Translation SDK と対話するクライアント オブジェクトを作成し、続いてそのクライアント オブジェクトのメソッドを呼び出してサービスと対話します。 SDK には同期メソッドと非同期メソッドの両方が用意されています。 詳細については、Python のテキスト翻訳サンプル リポジトリを参照してください。

ヘルプ オプション

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

次のステップ

テキスト翻訳のクイックスタート

テキスト翻訳 v3.0 リファレンス ガイド