Vorgänge der Dokumentübersetzung
Referenzfeature
: Azure AI Translator → Dokumentübersetzung
Die Dokumentübersetzung ist ein cloudbasiertes Feature des Azure KI-Übersetzerdiensts und Teil der Azure KI-Dienstfamilie von REST-APIs. Die Batchdokumentübersetzungs-API übersetzt Dokumente in allen unterstützten Sprachen und Dialekten , wobei die Dokumentstruktur und das Datenformat beibehalten werden. Die verfügbaren Methoden sind in den folgenden Tabellen aufgeführt:
API-Version: 2024-05-01
Hinweis
Die aktuelle Version ist abwärtskompatibel mit der Legacyversion.
Ab dieser aktuellen Version wird die
get supported storage sources
Methode länger unterstützt. Der Übersetzerdienst unterstützt nur Azure Blob Storage.
Anfordern | Methode | Beschreibung | API-Pfad |
---|---|---|---|
Single | Synchron | Document | Übersetzung |
Dokument übersetzen | POST | Synchrones Übersetzen eines einzelnen Dokuments. | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
Batch | Asynchron | Dokumente | Übersetzung |
Übersetzung starten | POST | Starten Sie einen Batchdokumentübersetzungsauftrag. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
Abrufen des Status für alle Übersetzungsaufträge | GET | Fordern Sie eine Liste und den Status der vom Benutzer übermittelten Übersetzungsaufträge an. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
Abrufen des Status für einen bestimmten Übersetzungsauftrag | GET | Fordern Sie eine Zusammenfassung des Status für einen bestimmten Übersetzungsauftrag an. Die Antwort enthält den Gesamtauftragsstatus und den Status für Dokumente, die als Teil dieses Auftrags übersetzt werden. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
Abrufen des Status für alle Dokumente | GET | Fordern Sie den Status aller Dokumente in einem Übersetzungsauftrag an. | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
Abrufen des Status für ein bestimmtes Dokument | GET | Fordern Sie den Status für ein bestimmtes Dokument in einem Auftrag an. | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
Übersetzung abbrechen | DELETE | Abbrechen eines Dokumentübersetzungsauftrags, der gerade verarbeitet oder in die Warteschlange gestellt wird. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
Abrufen unterstützter Dokumentformate | GET | Fordern Sie eine Liste der unterstützten Dokumentformate an. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
Abrufen unterstützter Glossarformate | GET | Fordern Sie eine Liste der unterstützten Glossarformate an. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
Vorversion
Hinweis
- Die Legacyversion ist abwärtskompatibel mit der aktuellen Version. Sie können die Vorgänge einer der Versionen verwenden, um Dokumente zu übersetzen.
- Es wird empfohlen, Ihre Anwendungen zur neuesten Version zu migrieren, um von einer verbesserten Benutzeroberfläche und erweiterten Funktionen zu profitieren.
Anfordern | Methode | Beschreibung | API-Pfad |
---|---|---|---|
Single | Synchron | Document | Übersetzung |
Dokument übersetzen | POST | Synchrones Übersetzen eines einzelnen Dokuments. | {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 | Asynchron | Dokumente | Übersetzung |
Übersetzung starten | POST | Starten Sie einen Batchdokumentübersetzungsauftrag. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
Abrufen des Status für alle Übersetzungsaufträge | GET | Fordern Sie eine Liste und den Status der vom Benutzer übermittelten Übersetzungsaufträge an. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
Abrufen des Status für einen bestimmten Übersetzungsauftrag | GET | Fordern Sie eine Zusammenfassung des Status für einen bestimmten Übersetzungsauftrag an. Die Antwort enthält den Gesamtauftragsstatus und den Status für Dokumente, die als Teil dieses Auftrags übersetzt werden. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
Abrufen des Status für alle Dokumente | GET | Fordern Sie den Status für ein bestimmtes Dokument in einem Auftrag an. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
Abrufen des Status für ein bestimmtes Dokument | GET | Fordern Sie den Status für ein bestimmtes Dokument in einem Auftrag an. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
Übersetzung abbrechen | DELETE | Abbrechen eines Dokumentübersetzungsauftrags, der gerade verarbeitet oder in die Warteschlange gestellt wird. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
Abrufen unterstützter Dokumentformate | GET | Fordern Sie eine Liste der unterstützten Dokumentformate an. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
Abrufen unterstützter Glossarformate | GET | Fordern Sie eine Liste der unterstützten Glossarformate an. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
Abrufen unterstützter Speicherquellen | GET | Fordern Sie eine Liste der unterstützten Speicherquellen/-optionen an. Derzeit unterstützt der Übersetzerdienst nur Azure Blob Storage. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |