Operacje tłumaczenia dokumentów
Funkcja referencyjna
: tłumaczenie dokumentów w usłudze Azure AI Translator →
Tłumaczenie dokumentów jest funkcją opartą na chmurze usługi Azure AI Translator i jest częścią rodziny usług Azure AI interfejsów API REST. Interfejs API tłumaczenia dokumentów wsadowych tłumaczy dokumenty we wszystkich obsługiwanych językach i dialektach przy zachowaniu struktury dokumentów i formatu danych. Dostępne metody są wymienione w następujących tabelach:
Wersja interfejsu API: 2024-05-01
Uwaga
Bieżąca wersja jest zgodna z poprzednimi wersjami.
Począwszy od bieżącej wersji, metoda nie jest już obsługiwana
get supported storage sources. Usługa Translator obsługuje tylko usługę Azure Blob Storage.
| Żądanie | Metoda | opis | Ścieżka interfejsu API |
|---|---|---|---|
| Pojedynczy | Synchroniczny | Document | Tłumaczenie |
| Tłumaczenie dokumentu | POST | Synchronicznie tłumacz pojedynczy dokument. | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| Batch | Asynchroniczny | Dokumenty | Tłumaczenie |
| Rozpocznij tłumaczenie | POST | Uruchom zadanie tłumaczenia dokumentów wsadowych. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Pobieranie stanu dla wszystkich zadań tłumaczenia | GET | Zażądaj listy i stanu zadań tłumaczenia przesłanych przez użytkownika. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Pobieranie stanu dla określonego zadania tłumaczenia | GET | Zażądaj podsumowania stanu określonego zadania tłumaczenia. Odpowiedź zawiera ogólny stan zadania i stan dokumentów, które są tłumaczone w ramach tego zadania. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Pobieranie stanu dla wszystkich dokumentów | GET | Zażądaj stanu wszystkich dokumentów w zadaniu tłumaczenia. | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| Uzyskiwanie stanu określonego dokumentu | GET | Zażądaj stanu określonego dokumentu w zadaniu. | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| Anulowanie tłumaczenia | DELETE | Anuluj zadanie tłumaczenia dokumentów, które jest obecnie przetwarzane lub kolejkowane. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Uzyskiwanie obsługiwanych formatów dokumentów | GET | Zażądaj listy obsługiwanych formatów dokumentów. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| Uzyskiwanie obsługiwanych formatów słownika | GET | Zażądaj listy obsługiwanych formatów słownika. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
Starsza wersja
Uwaga
- Starsza wersja jest zgodna z bieżącą wersją. Do tłumaczenia dokumentów można użyć operacji jednej z wersji.
- Zalecamy migrację aplikacji do najnowszej wersji, aby korzystać z ulepszonego środowiska i zaawansowanych możliwości.
| Żądanie | Metoda | opis | Ścieżka interfejsu API |
|---|---|---|---|
| Pojedynczy | Synchroniczny | Document | Tłumaczenie |
| Tłumaczenie dokumentu | POST | Synchronicznie tłumacz pojedynczy dokument. | {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 | Asynchroniczny | Dokumenty | Tłumaczenie |
| Rozpocznij tłumaczenie | POST | Uruchom zadanie tłumaczenia dokumentów wsadowych. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Pobieranie stanu dla wszystkich zadań tłumaczenia | GET | Zażądaj listy i stanu zadań tłumaczenia przesłanych przez użytkownika. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Pobieranie stanu dla określonego zadania tłumaczenia | GET | Zażądaj podsumowania stanu określonego zadania tłumaczenia. Odpowiedź zawiera ogólny stan zadania i stan dokumentów, które są tłumaczone w ramach tego zadania. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Pobieranie stanu dla wszystkich dokumentów | GET | Zażądaj stanu określonego dokumentu w zadaniu. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
| Uzyskiwanie stanu określonego dokumentu | GET | Zażądaj stanu określonego dokumentu w zadaniu. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| Anulowanie tłumaczenia | DELETE | Anuluj zadanie tłumaczenia dokumentów, które jest obecnie przetwarzane lub kolejkowane. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Uzyskiwanie obsługiwanych formatów dokumentów | GET | Zażądaj listy obsługiwanych formatów dokumentów. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
| Uzyskiwanie obsługiwanych formatów słownika | GET | Zażądaj listy obsługiwanych formatów słownika. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
| Uzyskiwanie obsługiwanych źródeł magazynu | GET | Zażądaj listy obsługiwanych źródeł/opcji magazynu. Obecnie usługa Translator obsługuje tylko usługę Azure Blob Storage. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |