Dokumentumfordítási műveletek
Referenciafunkció
: Azure AI Translator → dokumentumfordítás
A dokumentumfordítás az Azure AI Translator szolgáltatás felhőalapú funkciója, amely a REST API-k Azure AI-szolgáltatáscsaládjának része. A Batch Document Translation API lefordítja a dokumentumokat az összes támogatott nyelvre és nyelvjárásra , miközben megőrzi a dokumentumstruktúrát és az adatformátumot. A rendelkezésre álló módszerek a következő táblázatokban találhatók:
API-verzió: 2024-05-01
Feljegyzés
Az aktuális verzió visszamenőlegesen kompatibilis az örökölt verzióval.
Az aktuális verziótól kezdve a
get supported storage sourcesmetódus már nem támogatott. A Translator szolgáltatás csak az Azure Blob Storage-t támogatja.
| Kérés | Metódus | Leírás | API-elérési út |
|---|---|---|---|
| Nőtlen | Egyidejű | Dokumentum | Fordítás |
| Dokumentum fordítása | POST | Egyetlen dokumentum szinkron fordítása. | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| Batch | Aszinkron | Dokumentumok | Fordítás |
| Fordítás indítása | POST | Kötegelt dokumentumfordítási feladat indítása. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Az összes fordítási feladat állapotának lekérése | KAP | Kérje le a felhasználó által elküldött fordítási feladatok listáját és állapotát. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Adott fordítási feladat állapotának lekérése | KAP | Kérjen összegzést egy adott fordítási feladat állapotáról. A válasz tartalmazza a feladat általános állapotát és a feladat részeként lefordított dokumentumok állapotát. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Az összes dokumentum állapotának lekérése | KAP | Kérje le a fordítási feladat összes dokumentumának állapotát. | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| Adott dokumentum állapotának lekérése | KAP | Adott dokumentum állapotának kérése egy feladatban. | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| Fordítás megszakítása | Törlés... | A jelenleg feldolgozásra vagy várólistára helyezett dokumentumfordítási feladat megszakítása. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Támogatott dokumentumformátumok lekérése | KAP | A támogatott dokumentumformátumok listájának kérése. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| Támogatott szószedetformátumok lekérése | KAP | Kérje le a támogatott szószedetformátumok listáját. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
Örökölt
Feljegyzés
- Az örökölt verzió visszamenőlegesen kompatibilis az aktuális verzióval. A dokumentumok fordításához bármelyik verzió műveleteit használhatja.
- Javasoljuk, hogy az alkalmazásokat a legújabb verzióra migrálja a továbbfejlesztett felhasználói élmény és a speciális képességek kihasználásához.
| Kérés | Metódus | Leírás | API-elérési út |
|---|---|---|---|
| Nőtlen | Egyidejű | Dokumentum | Fordítás |
| Dokumentum fordítása | POST | Egyetlen dokumentum szinkron fordítása. | {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 | Aszinkron | Dokumentumok | Fordítás |
| Fordítás indítása | POST | Kötegelt dokumentumfordítási feladat indítása. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Az összes fordítási feladat állapotának lekérése | KAP | Kérje le a felhasználó által elküldött fordítási feladatok listáját és állapotát. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Adott fordítási feladat állapotának lekérése | KAP | Kérjen összegzést egy adott fordítási feladat állapotáról. A válasz tartalmazza a feladat általános állapotát és a feladat részeként lefordított dokumentumok állapotát. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Az összes dokumentum állapotának lekérése | KAP | Adott dokumentum állapotának kérése egy feladatban. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
| Adott dokumentum állapotának lekérése | KAP | Adott dokumentum állapotának kérése egy feladatban. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| Fordítás megszakítása | Törlés... | A jelenleg feldolgozásra vagy várólistára helyezett dokumentumfordítási feladat megszakítása. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Támogatott dokumentumformátumok lekérése | KAP | A támogatott dokumentumformátumok listájának kérése. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
| Támogatott szószedetformátumok lekérése | KAP | Kérje le a támogatott szószedetformátumok listáját. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
| Támogatott tárolási források lekérése | KAP | Kérje le a támogatott tárforrások/lehetőségek listáját. A Translator szolgáltatás jelenleg csak az Azure Blob Storage-t támogatja. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |