Operace překladu dokumentů
Referenční
funkce: Překlad dokumentů azure AI Translator →
Překlad dokumentů je cloudová funkce služby Azure AI Translator a je součástí řady rozhraní REST API služby Azure AI. Rozhraní API pro dávkové překlady dokumentů překládá dokumenty napříč všemi podporovanými jazyky a dialekty a zachovává strukturu dokumentů a formát dat. Dostupné metody jsou uvedeny v následujících tabulkách:
Verze rozhraní API: 2024-05-01
Poznámka:
Aktuální verze je zpětně kompatibilní se starší verzí.
Počínaje touto aktuální verzí
get supported storage sourcesse už metoda nepodporuje. Služba Translator podporuje pouze službu Azure Blob Storage.
| Žádost | metoda | Popis | Cesta k rozhraní API |
|---|---|---|---|
| Jednotlivý | Synchronní | Dokument | Překlad |
| Překlad dokumentu | POST | Synchronně přeloží jeden dokument. | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| Batch | Asynchronní | Dokumenty | Překlad |
| Zahájení překladu | POST | Spusťte dávkovou úlohu překladu dokumentů. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Získání stavu pro všechny úlohy překladu | GET | Požádejte o seznam a stav úloh překladu odeslaných uživatelem. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Získání stavu pro konkrétní úlohu překladu | GET | Požádejte o souhrn stavu pro konkrétní úlohu překladu. Odpověď zahrnuje celkový stav úlohy a stav dokumentů, které se překládají jako součást této úlohy. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Získání stavu pro všechny dokumenty | GET | Požádejte o stav všech dokumentů v úloze překladu. | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| Získání stavu pro konkrétní dokument | GET | Požádejte o stav konkrétního dokumentu v úloze. | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| Zrušit překlad | DELETE | Zrušení úlohy překladu dokumentu, která se právě zpracovává nebo zařadí do fronty | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Získání podporovaných formátů dokumentů | GET | Požádejte o seznam podporovaných formátů dokumentů. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| Získání podporovaných formátů glosáře | GET | Požádejte o seznam podporovaných formátů glosáře. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
Starší verze
Poznámka:
- Starší verze je zpětně kompatibilní s aktuální verzí. K překladudokumentůch
- Doporučujeme migrovat aplikace na nejnovější verzi, abyste mohli využívat vylepšené prostředí a pokročilé funkce.
| Žádost | metoda | Popis | Cesta k rozhraní API |
|---|---|---|---|
| Jednotlivý | Synchronní | Dokument | Překlad |
| Překlad dokumentu | POST | Synchronně přeloží jeden 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 | Asynchronní | Dokumenty | Překlad |
| Zahájení překladu | POST | Spusťte dávkovou úlohu překladu dokumentů. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Získání stavu pro všechny úlohy překladu | GET | Požádejte o seznam a stav úloh překladu odeslaných uživatelem. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Získání stavu pro konkrétní úlohu překladu | GET | Požádejte o souhrn stavu pro konkrétní úlohu překladu. Odpověď zahrnuje celkový stav úlohy a stav dokumentů, které se překládají jako součást této úlohy. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Získání stavu pro všechny dokumenty | GET | Požádejte o stav konkrétního dokumentu v úloze. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
| Získání stavu pro konkrétní dokument | GET | Požádejte o stav konkrétního dokumentu v úloze. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| Zrušit překlad | DELETE | Zrušení úlohy překladu dokumentu, která se právě zpracovává nebo zařadí do fronty | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Získání podporovaných formátů dokumentů | GET | Požádejte o seznam podporovaných formátů dokumentů. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
| Získání podporovaných formátů glosáře | GET | Požádejte o seznam podporovaných formátů glosáře. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
| Získání podporovaných zdrojů úložiště | GET | Požádejte o seznam podporovaných zdrojů a možností úložiště. Služba Translator v současné době podporuje pouze úložiště objektů blob v Azure. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |