Translator/Document Translation とは

Azure Cognitive Servicesにも翻訳機能のためのTranslatorが用意されています。昨日のBuild2021にてDocument TranslationというPowerPointやExcel,PDFなんかをそのまま翻訳できる機能がリリースされましたので早速使ってみることにしました。APIを介してCognitive Services側に指示を出していくので少し状況が掴みづらくて時間がかかりましたが無事に機能を試すことができたので共有まで。

使ってみる

Azure PortalからTranslatorのリソースを作成します。無料のプランでもDocument Translationは利用できます。

利用方法としては以下のイメージです。予めAzure Blob Storageに翻訳したい文書を格納するSourceコンテナと、翻訳後の文書を出力するTargetコンテナを作成しておきます。

その状態で、POSTMAN等のHTTPクライアントからエンドポイントに対してPOSTリクエストを投げ、翻訳を開始させます。GETリクエストを投げると現在の翻訳状況が確認できます。この際エンドポイントとしてカスタムエンドポイントを利用するようにしてください。Azure Portalから確認できるエンドポイントではありません。リソース名を以下のURLに挿入して利用します。

https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0-preview.1

リクエストの中身ですが、コンテナ内のすべてのファイルを翻訳したい場合は以下のようになります。コンテナは匿名アクセスを有効化せず、SASトークンで認証するようにしましょう。

payload.json

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://<STORAGE-NAME>.blob.core.windows.net/translatorsource?<SAS-TOKEN>"
            },
            "targets": [
                {
                    "targetUrl": "https://<STORAGE-NAME>.blob.core.windows.net/translatortarget?<SAS-TOKEN>",
                    "language": "ja"
                }
            ]
        }
    ]
}

SASトークンは認証情報付きのURLを発行して特定の期間アクセスを許可するものです。コンテナ上で右クリックすることで作成できます。

それぞれの翻訳プロセスにはOperation-Locationが割り当てられます。これはPOSTリクエストのレスポンスヘッダーから確認できます。

https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0-preview.1/batches/<OPERATION-LOCATION>

このURLに対してGETリクエストを投げるとそのプロセス単位で翻訳処理の状況を確認できます。Operation-Locationを指定しない場合はリソースに紐づいているプロセス全てに関して状況が出力されます。

response.json

    "value": [
        {
            "id": "cf72f27d-33a5-4a30-b9f5-67c0bc607982",
            "createdDateTimeUtc": "2021-05-28T01:28:55.0128022Z",
            "lastActionDateTimeUtc": "2021-05-28T01:28:57.1343876Z",
            "status": "Running",
            "summary": {
                "total": 4,
                "failed": 0,
                "success": 0,
                "inProgress": 4,
                "notYetStarted": 0,
                "cancelled": 0,
                "totalCharacterCharged": 0
            }
        }