Documentomzettingsbewerkingen
Referentiefunctie
: Azure AI Translator → documentomzetting
Documentomzetting is een cloudfunctie van de Azure AI Translator-service en maakt deel uit van de Azure AI-servicefamilie van REST API's. De Batch Document Translation-API vertaalt documenten in alle ondersteunde talen en dialecten en behoudt documentstructuur en gegevensindeling. De beschikbare methoden worden vermeld in de volgende tabellen:
API-versie: 2024-05-01
Notitie
De huidige versie is compatibel met eerdere versies.
Vanaf deze huidige versie wordt de
get supported storage sourcesmethode niet meer ondersteund. De Translator-service ondersteunt alleen Azure Blob Storage.
| Aanvraag | Wijze | Description | API-pad |
|---|---|---|---|
| Ongetrouwd | Synchroon | Document | Omzetting |
| Document vertalen | POSTEN | Een enkel document synchroon vertalen. | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| Batch | Asynchroon | Documenten | Omzetting |
| Vertaling starten | POSTEN | Start een batchdocumentvertalingstaak. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Status ophalen voor alle vertaaltaken | GET | Een lijst en de status van vertaaltaken aanvragen die door de gebruiker zijn ingediend. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Status ophalen voor een specifieke vertaaltaak | GET | Vraag een samenvatting van de status voor een specifieke vertaaltaak aan. Het antwoord bevat de algehele taakstatus en de status voor documenten die worden vertaald als onderdeel van die taak. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Status ophalen voor alle documenten | GET | Vraag de status van alle documenten in een vertaaltaak aan. | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| Status ophalen voor een specifiek document | GET | Vraag de status voor een specifiek document in een taak aan. | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| Vertaling annuleren | DELETE | Annuleer een documentvertalingstaak die momenteel wordt verwerkt of in de wachtrij is geplaatst. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Ondersteunde documentindelingen ophalen | GET | Een lijst met ondersteunde documentindelingen aanvragen. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| Ondersteunde woordenlijstindelingen ophalen | GET | Een lijst met ondersteunde woordenlijstindelingen aanvragen. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
Verouderd
Notitie
- De oudere versie is achterwaarts compatibel met de huidige versie. U kunt de bewerkingen van beide versies gebruiken om documenten te vertalen.
- U wordt aangeraden uw toepassingen te migreren naar de nieuwste versie om te profiteren van een verbeterde ervaring en geavanceerde mogelijkheden.
| Aanvraag | Wijze | Description | API-pad |
|---|---|---|---|
| Ongetrouwd | Synchroon | Document | Omzetting |
| Document vertalen | POSTEN | Een enkel document synchroon vertalen. | {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 | Asynchroon | Documenten | Omzetting |
| Vertaling starten | POSTEN | Start een batchdocumentvertalingstaak. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Status ophalen voor alle vertaaltaken | GET | Een lijst en de status van vertaaltaken aanvragen die door de gebruiker zijn ingediend. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Status ophalen voor een specifieke vertaaltaak | GET | Vraag een samenvatting van de status voor een specifieke vertaaltaak aan. Het antwoord bevat de algehele taakstatus en de status voor documenten die worden vertaald als onderdeel van die taak. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Status ophalen voor alle documenten | GET | Vraag de status voor een specifiek document in een taak aan. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
| Status ophalen voor een specifiek document | GET | Vraag de status voor een specifiek document in een taak aan. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| Vertaling annuleren | DELETE | Annuleer een documentvertalingstaak die momenteel wordt verwerkt of in de wachtrij is geplaatst. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Ondersteunde documentindelingen ophalen | GET | Een lijst met ondersteunde documentindelingen aanvragen. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
| Ondersteunde woordenlijstindelingen ophalen | GET | Een lijst met ondersteunde woordenlijstindelingen aanvragen. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
| Ondersteunde opslagbronnen ophalen | GET | Een lijst met ondersteunde opslagbronnen/opties aanvragen. Momenteel ondersteunt de Translator-service alleen Azure Blob Storage. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |