同期ドキュメント翻訳

リファレンス
機能: Azure AI 翻訳 → ドキュメント翻訳
API バージョン: 2024-05-01
HTTP メソッド: POST

• translate document メソッドを使用して、1 つのドキュメントを同期的に翻訳します。
• この方法では、Azure Blob Storage アカウントは必要ありません。
• 最後の応答に翻訳されたドキュメントが含まれており、それが呼び出し元のクライアントに直接返されます。

重要

ドキュメント翻訳機能に対するすべての API 要求に、Azure portal のリソース概要ページにあるカスタム ドメイン エンドポイントが必要です。

要求 URL

curl -i -X POST "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version={date}" -H "Ocp-Apim-Subscription-Key:{your-key}"  -F "document={path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -F "glossary={path-to-your-glossary-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file}"

要求ヘッダー

REST API を介して同期翻訳機能を呼び出すには、各要求に次のヘッダーを含めます。

ヘッダー	値	条件
Ocp-Apim-Subscription-Key	Azure portal からの Translator サービス キー。	• 必須

要求パラメーター

クエリ文字列パラメーター:

必須のパラメーター

Query parameter (クエリ パラメーター)	説明
api-version	"必須のパラメーター"。 クライアントによって要求される API のバージョン。 現在の値は 2024-05-01 です。
targetLanguage	"必須のパラメーター"。 出力ドキュメントの言語を指定します。 ターゲット言語は、翻訳スコープに含まれているサポートされている言語のいずれかとする必要があります。
• document= • type=	"必須のパラメーター"。 • ソース ドキュメントのファイルの場所のパスとファイル形式の種類。 • 例: "document=@C:\Test\Test-file.txt;type=text/html
--output	"必須のパラメーター"。 • ターゲット ファイルの場所のパス。 翻訳されたファイルは出力ファイルに出力されます。 • 例: "C:\Test\Test-file-output.txt"。 ファイル拡張子はソース ファイルと同じである必要があります。

オプション パラメーター

Query parameter (クエリ パラメーター)	説明
sourceLanguage	入力ドキュメントの言語を指定します。 sourceLanguage パラメーターが指定されていない場合は、自動言語検出が適用されてソース言語が特定されます。
• glossary= • type=	• カスタム用語集のファイルの場所のパスとファイル形式の種類。 • 例:"glossary=@D:\Test\SDT\test-simple-glossary.csv;type=text/csv
allowFallback	• カスタム システムが存在しない場合にサービスが generalnn システムに切り替えられるよう指定するブール値。 指定できる値は true (既定値) または false です。 • allowFallback=false は、要求によって指定されたカテゴリ向けにトレーニングされたシステムのみを翻訳で使用することを指定します。 • 特定のカテゴリを持つシステムが見つからない場合、要求は 400 状態コードを返します。 • allowFallback=true は、カスタム システムが存在しない場合に、サービスが generalnn システムに切り替えられるよう指定します。
category	翻訳のカテゴリ (ドメイン) を指定する文字列。 このパラメーターは、Custom Translator でビルドしたカスタマイズされたシステムから翻訳を取得するために使用します。 展開済みのカスタマイズされたシステムを同期ドキュメント翻訳に使用するには、カスタム翻訳ツール プロジェクトの詳細の Category ID を、category パラメーターに追加します。 既定値は generalnn です。

要求本文

名前	説明	Content Type	条件
document	翻訳対象のソース ドキュメント。	サポートされているドキュメント形式のいずれか。	必須
glossary	翻訳プロセス中に使用する用語と定義の一覧を含むドキュメント。	サポートされている用語集の形式のいずれか。	オプション

次のステップ

ドキュメント翻訳のクイックスタートを試す