Azure Translator ドキュメント翻訳とは

ドキュメント翻訳は、 Foundry Tools の Azure Translator のクラウドベースの機械翻訳機能です。 元のドキュメント構造とデータ形式を維持しながら、 サポートされているすべての言語と方言 で複数の複雑なドキュメントを翻訳します。 Document Translation API では、2 つの翻訳プロセスがサポートされています。

  • 非同期バッチ翻訳では、複数のドキュメントと大きなファイルの処理がサポートされます。 バッチ翻訳プロセスでは、翻訳前と翻訳後のドキュメント用のストレージ コンテナーを含む Azure Blob Storage アカウントが必要です。

  • 同期単一ファイルでは、単一ファイルの翻訳の処理がサポートされます。 このファイル翻訳プロセスでは、Azure Blob Storage アカウントは必要ありません。 最後の応答に翻訳されたドキュメントが含まれており、それが呼び出し元のクライアントに直接返されます。

[前提条件]

非同期バッチ変換の前提条件

開始する前に、次のものが必要です。

同期変換の前提条件

開始する前に、次のものが必要です。

ヒント

Azure Key Vault などのセキュリティで保護された場所にサブスクリプション キーを格納し、ソース管理にキーを配置しないようにします。

主な機能

特徴量 説明
大きなファイルを翻訳する ドキュメント全体を非同期に翻訳します。
多数のファイルを翻訳する ドキュメント構造とデータ形式を維持しながら、サポートされているすべての言語と方言の間で複数のファイルを翻訳します。
画像ファイル形式 🆕を翻訳する • 元のデザインとレイアウトを維持しながら、画像内のテキストを翻訳します。
• サポートされている形式: .jpeg、 .png、 .bmp、 .webp
• 価格: 画像単位で計算されます。 詳細については、価格に関するページをご覧ください。
Word ドキュメント (.docx) およびPowerPoint ファイル (.pptx) 🆕 内の画像テキストを変換します。 この機能は、および.docxファイル形式の.pptx API で使用できます。
ソース ファイルの表示を保持する 元のレイアウトと形式を維持したままファイルを翻訳します。
カスタム翻訳を適用する 汎用およびカスタム翻訳モデルを使用してドキュメントを翻訳します。
カスタム用語集を適用する カスタム用語集を使用してドキュメントを翻訳します。
ドキュメントの言語を自動的に検出する ドキュメント翻訳サービスでドキュメントの言語を決定します。
コンテンツで複数の言語が使用されているドキュメントを翻訳する 自動検出機能を使用して、複数の言語のコンテンツが含まれるドキュメントをターゲット言語に翻訳します。

ドキュメント翻訳のしくみ

ドキュメント翻訳では、2 つのワークフローがサポートされています。 シナリオに合ったアプローチを選択します。

非同期 (バッチ)

  1. ソース ドキュメントをソース コンテナーにアップロードします。
  2. バッチ変換要求を送信します。
  3. ジョブとドキュメントの状態を監視します。
  4. ターゲット コンテナーから翻訳されたドキュメントをダウンロードします。

要求/応答フローの詳細については、 ドキュメント翻訳 REST API リファレンス ガイドを参照してください。

Synchronous

  1. 1 つのドキュメント (および省略可能な用語集) を含む要求を送信します。
  2. 返信で翻訳されたドキュメントを受け取ります。

要求の詳細と例については、「 同期ドキュメントの翻訳」を参照してください。

開発オプション

次の開発オプションを使用して、プロジェクトとアプリケーションにドキュメント翻訳を追加します。

注

Foundry ポータルでは現在、同期 (単一ファイル) ドキュメント翻訳のみがサポートされています。 非同期バッチ ドキュメント変換には、REST API またはクライアント ライブラリを使用します。

非同期ワークフローを使用して、複数のドキュメントと大きなファイルを翻訳します。

開発オプション 説明
REST API REST API は、ドキュメントを翻訳するための HTTP 要求と承認ヘッダーを作成できる、言語に依存しないインターフェイスです。
クライアント ライブラリ (SDK) .NET/C#、Python、JavaScript/TypeScript、またはJava用のドキュメント翻訳クライアント ライブラリを使用します。

サポートされているドキュメントと用語集の形式

次の表に、各翻訳方法でサポートされているドキュメントと用語集のファイル形式を示します。

Batch ドキュメントでサポートされている形式

Get サポートされているドキュメント形式メソッドは、ドキュメント翻訳サービスでサポートされているドキュメント形式の一覧を返します。 一覧には、一般的なファイル拡張子とコンテンツ タイプが含まれています。

ファイルの種類 ファイル拡張子 説明
Adobe PDF pdf 移植可能なドキュメント ファイル形式。 ドキュメント翻訳では、光学式文字認識 (OCR) テクノロジを使用して、元のレイアウトを保持しながら、スキャンした PDF ドキュメント内のテキストを抽出して翻訳します。
コンマ区切りの値 csv スプレッドシート プログラムによって使用される、コンマ区切りの生データ ファイル。
HTML html、htm ハイパー テキスト マークアップ言語。
画像 (2025-12-01-プレビュー) .jpeg、 .png、 .bmp、 .webp デジタル画像データを格納するファイル。
OpenDocument プレゼンテーション odp オープンソースのプレゼンテーション ファイル。
OpenDocument スプレッドシート ods オープンソースのスプレッドシート ファイル。
OpenDocument テキスト odt オープンソースのテキスト ドキュメント ファイル。
Markdown markdown、 mdown、 mkdn、 md、 mkd、 mdwn、 mdtxt、 mdtext、 rmd 書式設定されたテキストを作成するための軽量マークアップ言語。
M​HTML mhtml、mht HTML コードとその関連リソースを結合するために使用される Web ページ アーカイブ形式。
マイクロソフト Excel xls、xlsx データ分析とドキュメント用のスプレッドシート ファイル。
マイクロソフト アウトルック msg Microsoft Outlook で作成または保存された電子メール メッセージ。 Unicode 形式.msgファイルのみ。 ANSI 形式の.msg ファイルはサポートされていません。
Microsoft PowerPoint ppt、pptx スライドショー形式でコンテンツを表示するために使用されるプレゼンテーション ファイル。
マイクロソフトワード doc、docx テキスト ドキュメント ファイル。
リッチ テキスト形式 rtf 書式設定を含むテキスト ドキュメント。
タブ区切り値/TAB tsv/tab スプレッドシート プログラムによって使用される、タブ区切りの生データ ファイル。
テキスト txt 書式設定のないテキスト ドキュメント。
XLIFF xlf 翻訳とローカライズで使用される並列ドキュメント形式。

バッチ レガシ ファイルの種類

ソース ファイルの種類は、以下の例外を除いて、ドキュメントの翻訳中に保持されます。

ソース ファイルの拡張子 翻訳されたファイルの拡張子
.doc、.odt、.rtf、 .docx
.xls、.ods .xlsx
.ppt、.odp .pptx

Batch 用語集でサポートされている形式

ドキュメント翻訳では、次の用語集のファイルの種類がサポートされています。

ファイルの種類 ファイル拡張子 説明
コンマ区切りの値 csv スプレッドシート プログラムによって使用される、コンマ区切りの生データ ファイル。
XLIFF xlf 翻訳とローカライズで使用される並列ドキュメント形式。
タブ区切りの値/TAB tsv、tab スプレッドシート プログラムによって使用される、タブ区切りの生データ ファイル。

ドキュメント翻訳要求の制限

Translator 要求の制限の詳細については、「 ドキュメント翻訳要求の制限」を参照してください。

ドキュメント翻訳データの保存場所

Translator リソースを作成するリージョンによって、ドキュメント コンテンツが処理され、一時的に格納される場所が決まります。 処理場所、カスタム エンドポイント要件、マネージド ID に関する考慮事項については、Azure Translatorのリージョンのサポートを参照してください。

トラブルシューティング

次のチェックを使用して、一般的な問題を診断します。

バッチ変換

同期翻訳

  • 無効なパラメーターまたはサポートされていないファイルの種類が原因で要求が失敗した場合は、 同期ドキュメント変換で必要なパラメーターとサポートされている形式を確認してください。
  • レート制限に達した場合は、「 ドキュメント翻訳要求の制限」を参照してください。

関連コンテンツ

  • Last updated on