次の方法で共有

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

  • [アーティクル]

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

要求 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 応答コードが返され、サービスによって要求が作成されたことが示されます。

次のステップ

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