ドキュメント翻訳操作

  • [アーティクル]

リファレンス
機能: Azure AI Translator → ドキュメント翻訳

ドキュメント翻訳は、Azure AI 翻訳サービスのクラウドベースの機能であり、REST API の Azure AI サービス ファミリの一部です。 Batch Document Translation API は、ドキュメント構造とデータ形式を維持しながらサポートされているすべての言語と方言にドキュメントを翻訳します。 使用可能なメソッドを次の表に示します。

API バージョン: 2024-05-01

Note

  • 現在のバージョンは、レガシ バージョンと下位互換性があります。

  • この現在のバージョン以降、 get supported storage sources メソッドはサポートされなくなりました。 Translator サービスでは、Azure Blob Storage のみがサポートされます。

要求 Method 説明 API パス
Single 同期 Document 翻訳
文書を翻訳する 投稿 1 つのドキュメントを同期的に翻訳します。 {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date}
Batch 非同期 ドキュメント 翻訳
翻訳を開始する 投稿 バッチ ドキュメント変換ジョブを開始します。 {document-translation-endpoint}/translator/document/batches?api-version={date}
すべての翻訳ジョブの状態を取得する GET ユーザーによって送信された翻訳ジョブの一覧と状態を要求します。 {document-translation-endpoint}/translator/document/batches?api-version={date}
特定の翻訳ジョブの状態を取得する GET 特定の翻訳ジョブの状態の概要を要求します。 応答には、ジョブ全体の状態と、そのジョブの一部として翻訳されるドキュメントの状態が含まれます。 {document-translation-endpoint}/translator/document/batches/{id}?api-version={date}
すべてのドキュメントの状態を取得する GET 翻訳ジョブ内のすべてのドキュメントの状態を要求します。 {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date}
特定のドキュメントの状態を取得する GET ジョブ内の特定のドキュメントの状態を要求します。 {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date}
翻訳の取り消し DELETE 現在処理中またはキューに登録されているドキュメント翻訳ジョブを取り消します。 {document-translation-endpoint}/translator/document/batches/{id}?api-version={date}
サポートされるドキュメントの形式の取得 GET サポートされているドキュメント形式の一覧を要求します。 {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document
サポートされる用語集の形式の取得 GET サポートされている用語集の形式の一覧を要求します。 {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary

従来

Note

  • レガシ バージョンは、現在のバージョンと下位互換性があります。 いずれかのバージョンの操作を使用して、ドキュメントを翻訳できます。
  • 強化されたエクスペリエンスと高度な機能の恩恵を受けるために、アプリケーションを最新バージョンに移行することをお勧めします。
要求 Method 説明 API パス
Single 同期 Document 翻訳
文書を翻訳する 投稿 1 つのドキュメントを同期的に翻訳します。 {document-translation-endpoint}/translator/document:translate?sourceLanguage={source language}&targetLanguage={target language}&api-version=2024-05-01" -H "Ocp-Apim-Subscription-Key:{your-key}" -F "document={path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -F "glossary={path-to-your-glossary-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file}"
Batch 非同期 ドキュメント 翻訳
翻訳を開始する 投稿 バッチ ドキュメント変換ジョブを開始します。 {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches
すべての翻訳ジョブの状態を取得する GET ユーザーによって送信された翻訳ジョブの一覧と状態を要求します。 {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches
特定の翻訳ジョブの状態を取得する GET 特定の翻訳ジョブの状態の概要を要求します。 応答には、ジョブ全体の状態と、そのジョブの一部として翻訳されるドキュメントの状態が含まれます。 {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}
すべてのドキュメントの状態を取得する GET ジョブ内の特定のドキュメントの状態を要求します。 {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents
特定のドキュメントの状態を取得する GET ジョブ内の特定のドキュメントの状態を要求します。 {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId}
翻訳の取り消し DELETE 現在処理中またはキューに登録されているドキュメント翻訳ジョブを取り消します。 {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}
サポートされるドキュメントの形式の取得 GET サポートされているドキュメント形式の一覧を要求します。 {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats
サポートされる用語集の形式の取得 GET サポートされている用語集の形式の一覧を要求します。 {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats
サポートされるストレージ ソースの取得 GET サポートされているストレージ ソース/オプションの一覧を要求します。 現時点では、Translator サービスでは Azure Blob Storage のみがサポートされています。 {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources

C# および Python プログラミング言語用のクライアント ライブラリと SDK について説明します。。