ソース言語を指定して文書を翻訳。
要求 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 応答で受け取るには、同期翻訳処理を使います。
| Query parameter (クエリ パラメーター) | 説明 | 条件 |
|---|---|---|
-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
- 各サンプルは、
localhostコマンドで指定したdocker compose upで実行されます。 - コンテナーの実行中、
localhostはコンテナー自体を指します。 -
localhost:5000を使用する必要はありません。 ホスト環境でまだ使用されていない任意のポートを使用できます。
サンプル ドキュメント
このプロジェクトでは、翻訳するソース ドキュメントが必要です。
ドキュメントの翻訳サンプル ドキュメントをダウンロードしcompose.yaml ファイル (container-environment) と同じフォルダーに保存できます。 ファイル名は document-translation-sample.docx で、ソース言語は英語です。
Azure 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応答コードが返され、サービスによって要求が作成されたことが示されます。