従来の Document Translation REST API (バージョン 2024-05-01) では、同期単一ドキュメント変換、非同期バッチ変換、および検出操作がサポートされています。 同期翻訳は、Blob Storageなしで 1 つのドキュメントを処理し、翻訳されたファイルを直接返します。 非同期バッチ変換では、Azure Blob Storageに格納されている 1 つ以上のドキュメントが処理され、状態をポーリングできます。
すべての要求にはカスタム ドメイン エンドポイントが必要です。 形式は https://{your-resource-name}.cognitiveservices.azure.com/。
Note
新しいアプリケーションの場合は、 Document Translation REST API バージョン 2026-03-01 を使用します。
同期操作
| Operation | Method | 説明 | Reference |
|---|---|---|---|
| ドキュメントを翻訳する | POST |
1 つのドキュメントを翻訳し、応答で翻訳された出力を受け取ります。 Blob Storageは必要ありません。 | 同期ドキュメント翻訳 |
非同期バッチ操作
| Operation | Method | 説明 | Reference |
|---|---|---|---|
| バッチ翻訳を開始する | POST |
非同期翻訳用に 1 つ以上のドキュメントを送信します。 ドキュメントはAzure Blob Storageに含まれる必要があります。 ジョブ ID を返します。 | バッチ翻訳を開始する |
| 翻訳の状態を取得する | GET |
特定のバッチ ジョブの全体的な状態とドキュメントの概要を取得します。 ジョブが終了状態になるまでポーリングします。 | 翻訳の状態を取得する |
| すべての翻訳の状態を取得する | GET |
リソースに送信されたすべてのバッチ変換ジョブを一覧表示します。 フィルター処理とページングをサポートします。 | すべての翻訳ジョブの状態を取得する |
| すべてのドキュメントの状態を取得する | GET |
特定のジョブ内のすべてのドキュメントのドキュメントごとの状態を取得します。 | すべてのドキュメントの状態を取得する |
| 特定のドキュメントの状態を取得する | GET |
ジョブ内の 1 つのドキュメントの状態と出力の詳細を取得します。 | 特定のドキュメントの状態を取得する |
| 翻訳の取り消し | DELETE |
キューに入っているジョブまたは進行中のジョブを取り消します。 | 翻訳の取り消し |
検出操作
| Operation | Method | 説明 | Reference |
|---|---|---|---|
| サポートされるドキュメントの形式の取得 | GET |
サポートされているドキュメント形式とその MIME の種類の一覧を取得します。 | サポートされているドキュメント形式を取得する |
| サポートされる用語集の形式の取得 | GET |
サポートされている用語集の形式とその MIME の種類の一覧を取得します。 | サポートされている用語集の形式を取得する |
以前の v1.1 バッチ API
以前の v1.1 API では、 /translator/text/batch/v1.1 パスでの非同期バッチ操作と検出操作がサポートされています。
Get supported storage sources操作は v1.1 でのみ使用できます。 Translator では、ストレージ ソースとしてAzure Blob Storageがサポートされています。
現在の機能を使用するには、既存のアプリケーションを最新の API バージョンに移行することをお勧めします。
| Operation | Method | API パス |
|---|---|---|
| バッチ翻訳を開始する | POST |
/translator/text/batch/v1.1/batches |
| すべての翻訳ジョブの状態を取得する | GET |
/translator/text/batch/v1.1/batches |
| 特定の翻訳ジョブの状態を取得する | GET |
/translator/text/batch/v1.1/batches/{id} |
| すべてのドキュメントの状態を取得する | GET |
/translator/text/batch/v1.1/batches/{id}/documents |
| 特定のドキュメントの状態を取得する | GET |
/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| 翻訳の取り消し | DELETE |
/translator/text/batch/v1.1/batches/{id} |
| サポートされるドキュメントの形式の取得 | GET |
/translator/text/batch/v1.1/documents/formats |
| サポートされる用語集の形式の取得 | GET |
/translator/text/batch/v1.1/glossaries/formats |
| サポートされているストレージ ソースを取得する | GET |
/translator/text/batch/v1.1/storagesources |