Åtgärder för dokumentöversättning
Referensfunktion
: Azure AI Translator → dokumentöversättning
Dokumentöversättning är en molnbaserad funktion i Azure AI Translator-tjänsten och ingår i Azure AI-tjänstfamiljen med REST-API:er. API:et för dokumentöversättning i Batch översätter dokument över alla språk och dialekter som stöds samtidigt som dokumentstrukturen och dataformatet bevaras . De tillgängliga metoderna visas i följande tabeller:
API-version: 2024-05-01
Kommentar
Den aktuella versionen är bakåtkompatibel med den äldre versionen.
Från och med den aktuella versionen
get supported storage sourcesstöds inte längre metoden. Translator-tjänsten stöder endast Azure Blob Storage.
| Förfrågan | Metod | beskrivning | API-sökväg |
|---|---|---|---|
| Singel | Synkron | Dokument | Översättning |
| Översätta dokument | POST | Översätta ett enskilt dokument synkront. | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| Batch | Asynkron | Dokument | Översättning |
| Starta översättning | POST | Starta ett batchdokumentöversättningsjobb. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Hämta status för alla översättningsjobb | GET | Begär en lista och status för översättningsjobb som skickats av användaren. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Hämta status för ett visst översättningsjobb | GET | Begär en sammanfattning av statusen för ett visst översättningsjobb. Svaret innehåller den övergripande jobbstatusen och statusen för dokument som översätts som en del av jobbet. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Hämta status för alla dokument | GET | Begär status för alla dokument i ett översättningsjobb. | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| Hämta status för ett visst dokument | GET | Begär status för ett visst dokument i ett jobb. | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| Avbryt översättning | DELETE | Avbryt ett dokumentöversättningsjobb som för närvarande bearbetas eller placeras i kö. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Hämta dokumentformat som stöds | GET | Begär en lista över dokumentformat som stöds. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| Hämta ordlisteformat som stöds | GET | Begär en lista över ordlisteformat som stöds. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
Legacy
Kommentar
- Den äldre versionen är bakåtkompatibel med den aktuella versionen. Du kan använda någon av versionernas åtgärder för att översätta dokument.
- Vi rekommenderar att du migrerar dina program till den senaste versionen för att dra nytta av en förbättrad upplevelse och avancerade funktioner.
| Förfrågan | Metod | beskrivning | API-sökväg |
|---|---|---|---|
| Singel | Synkron | Dokument | Översättning |
| Översätta dokument | POST | Översätta ett enskilt dokument synkront. | {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 | Asynkron | Dokument | Översättning |
| Starta översättning | POST | Starta ett batchdokumentöversättningsjobb. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Hämta status för alla översättningsjobb | GET | Begär en lista och status för översättningsjobb som skickats av användaren. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Hämta status för ett visst översättningsjobb | GET | Begär en sammanfattning av statusen för ett visst översättningsjobb. Svaret innehåller den övergripande jobbstatusen och statusen för dokument som översätts som en del av jobbet. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Hämta status för alla dokument | GET | Begär status för ett visst dokument i ett jobb. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
| Hämta status för ett visst dokument | GET | Begär status för ett visst dokument i ett jobb. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| Avbryt översättning | DELETE | Avbryt ett dokumentöversättningsjobb som för närvarande bearbetas eller placeras i kö. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Hämta dokumentformat som stöds | GET | Begär en lista över dokumentformat som stöds. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
| Hämta ordlisteformat som stöds | GET | Begär en lista över ordlisteformat som stöds. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
| Hämta lagringskällor som stöds | GET | Begär en lista över lagringskällor/alternativ som stöds. För närvarande stöder Translator-tjänsten endast Azure Blob Storage. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |