Dokumentübersetzungsvorgänge

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

Erkunden Sie unsere Clientbibliotheken und SDKs für C#- und Python-Programmiersprachen..