Freigeben über


Dokumentübersetzungsvorgänge

Referenzfeature
: Azure Translator → Dokumentübersetzung

Die Dokumentübersetzung ist ein cloudbasiertes Feature von Azure Translator und ist Teil der Foundry Tool-Familie von REST-APIs. Die Batchdokumentübersetzungs-API übersetzt Dokumente in alle unterstützten Sprachen und Dialekte , 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.

  • Mit dieser aktuellen Version und höheren Versionen wird die get supported storage sources Methode nicht mehr unterstützt. Der Übersetzer 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 Translator nur Azure Blob Storage. {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources