Leitfaden zur Rest-API für die Dokumentübersetzung (2024-05-01)

Die ältere REST-API ( 2024-05-01Dokumentübersetzung) unterstützt synchrone Einzeldokumentübersetzung, asynchrone Batchübersetzung und Ermittlungsvorgänge. Synchrone Übersetzung verarbeitet ein einzelnes Dokument ohne Blob Storage und gibt die übersetzte Datei direkt zurück. Die asynchrone Batchübersetzung verarbeitet ein oder mehrere dokumente, die in Azure Blob Storage gespeichert sind, und ermöglicht es Ihnen, den Status zu abfragen.

Für alle Anforderungen ist ein benutzerdefinierter Domänenendpunkt erforderlich. Das Format ist https://{your-resource-name}.cognitiveservices.azure.com/.

Hinweis

Verwenden Sie für neue Anwendungen die REST-API für die Dokumentübersetzung, Version 2026-03-01.

Synchrone Vorgänge

Operation Methode Beschreibung Reference
Übersetzen eines Dokuments POST Übersetzen Sie ein einzelnes Dokument, und empfangen Sie die übersetzte Ausgabe in der Antwort. Kein Blob Storage erforderlich. Synchrone Dokumentübersetzung

Asynchrone Batchvorgänge

Operation Methode Beschreibung Reference
Batchübersetzung starten POST Übermitteln Sie mindestens ein Dokument für eine asynchrone Übersetzung. Dokumente müssen in Azure Blob Storage sein. Gibt eine Auftrags-ID zurück. Batchübersetzung starten
Übersetzungsstatus abrufen GET Rufen Sie den Gesamtstatus und die Dokumentzusammenfassung für einen bestimmten Batchauftrag ab. Abrufen, bis der Auftrag einen Terminalzustand erreicht. Übersetzungsstatus abrufen
Abrufen des Status für alle Übersetzungen GET Auflisten aller an Ihre Ressource übermittelten Batchübersetzungsaufträge. Unterstützt Das Filtern und Paging. Abrufen des Status für alle Übersetzungsaufträge
Abrufen des Status für alle Dokumente GET Abrufen des Status pro Dokument für alle Dokumente in einem bestimmten Auftrag. Abrufen des Status für alle Dokumente
Abrufen des Status eines bestimmten Dokuments GET Abrufen von Status- und Ausgabedetails für ein einzelnes Dokument innerhalb eines Auftrags. Abrufen des Status für ein bestimmtes Dokument
Übersetzung abbrechen DELETE Abbrechen eines Auftrags, der in der Warteschlange oder in Bearbeitung ist. Übersetzung abbrechen

Ermittlungsvorgänge

Operation Methode Beschreibung Reference
Unterstützte Dokumentformate abrufen GET Dient zum Abrufen einer Liste der unterstützten Dokumentformate und deren MIME-Typen. Abrufen unterstützter Dokumentformate
Erhalten Sie unterstützte Glossarformate GET Rufen Sie eine Liste der unterstützten Glossarformate und deren MIME-Typen ab. Abrufen unterstützter Glossarformate

Frühere v1.1-Batch-API

Die frühere v1.1-API unterstützt asynchrone Batch- und Ermittlungsvorgänge unter dem /translator/text/batch/v1.1 Pfad. Der Get supported storage sources Vorgang ist nur in Version 1.1 verfügbar. Translator unterstützt Azure Blob Storage als Speicherquelle.

Es wird empfohlen, vorhandene Anwendungen zur neuesten API-Version zu migrieren, um aktuelle Funktionen zu verwenden.

Operation Methode API-Pfad
Batchübersetzung starten POST /translator/text/batch/v1.1/batches
Abrufen des Status für alle Übersetzungsaufträge GET /translator/text/batch/v1.1/batches
Abrufen des Status für einen bestimmten Übersetzungsauftrag GET /translator/text/batch/v1.1/batches/{id}
Abrufen des Status für alle Dokumente GET /translator/text/batch/v1.1/batches/{id}/documents
Abrufen des Status eines bestimmten Dokuments GET /translator/text/batch/v1.1/batches/{id}/documents/{documentId}
Übersetzung abbrechen DELETE /translator/text/batch/v1.1/batches/{id}
Unterstützte Dokumentformate abrufen GET /translator/text/batch/v1.1/documents/formats
Erhalten Sie unterstützte Glossarformate GET /translator/text/batch/v1.1/glossaries/formats
Abrufen unterstützter Speicherquellen GET /translator/text/batch/v1.1/storagesources