コンテナー: ドキュメントを翻訳する

ソース言語を指定して文書を翻訳。

要求 URL (cURL を使用)

POST 依頼：

    POST "http://localhost:{port}/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version={api-version}" -F "document=@{path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file-with-file-extension}"

例:

curl -i -X POST "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2024-05-01" -F "document=@C:\Test\test-file.md;type=text/markdown" -o "C:\translation\translated-file.md"

同期要求ヘッダーとパラメーター

HTTP 要求本文の一部としてドキュメントを送信し、翻訳されたドキュメントを HTTP 応答で受け取るには、同期翻訳処理を使います。

クエリ パラメーター	説明	条件
-X または --requestPOST	-X フラグは、API にアクセスするための要求メソッドを指定します。	必須
{endpoint}	ドキュメント翻訳リソース エンドポイントの URL	必須
targetLanguage	出力ドキュメントの言語を指定します。 ターゲット言語は、翻訳スコープに含まれているサポートされている言語のいずれかとする必要があります。	必須
sourceLanguage	入力ドキュメントの言語を指定します。 sourceLanguage パラメーターが指定されていない場合は、自動言語検出が適用されてソース言語が特定されます。	オプション
-H または --header"Ocp-Apim-Subscription-Key:{KEY}	API へのアクセスを承認するドキュメント翻訳リソース キーを指定する要求ヘッダー。	必須
-F または --form	要求に含めるドキュメントのファイルパス。 許可されるソース ドキュメントは 1 つだけです。	必須
• document= • type={contentType}/fileExtension	• ソース ドキュメントのファイルの場所のパス。 • コンテンツの種類とファイル拡張子。 例: "document=@C:\Test\test-file.md;type=text/markdown"	必須
-o または --output	応答結果のファイルパス。	必須
-F または --form	要求に含めるオプションの用語集のファイルパス。 用語集には別個の --form フラグが必要です。	オプション
• glossary= • type={contentType}/fileExtension	• オプションの用語集ファイルを示すファイルの場所のパス。 • コンテンツの種類とファイル拡張子。 例: "glossary=@C:\Test\glossary-file.txt;type=text/plain	オプション

✔️ contentType の詳細については、サポートされるドキュメントの形式を参照してください。

コード サンプル: ドキュメント翻訳

Note

• 各サンプルは、docker compose up コマンドで指定したlocalhostで実行されます。
• コンテナーの実行中、 localhost はコンテナー自体を指します。
• localhost:5000を使用する必要はありません。 ホスト環境でまだ使用されていない任意のポートを使用できます。

サンプル ドキュメント

このプロジェクトでは、翻訳するソース ドキュメントが必要です。 ドキュメントの翻訳サンプル ドキュメントをダウンロードしcompose.yaml ファイル (container-environment) と同じフォルダーに保存できます。 ファイル名は document-translation-sample.docx で、ソース言語は英語です。

Azure AI Translator エンドポイントにクエリを実行する (ドキュメント)

localhost:5000 を使用した cURL HTTP 要求の例を次に示します。

curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2024-05-01" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"

"正常に完了した場合":

• 翻訳されたドキュメントが応答で返されます。
• 成功した POST メソッドから 200 OK 応答コードが返され、サービスによって要求が作成されたことが示されます。

次のステップ

同期ドキュメント翻訳の詳細