ドキュメント翻訳の操作
リファレンス
機能: 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 |