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 nicht mehr unterstützt. Der Übersetzerdienst unterstützt nur Azure Blob Storage.

Anfordern Methode Beschreibung API-Pfad
Unverheiratet 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
Unverheiratet 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