Opérations de traduction de documents

Fonctionnalité de référence
: Traduction de documents → Azure Translator

La traduction de documents est une fonctionnalité basée sur le cloud d’Azure Translator et fait partie de la famille de services Azure AI d’API REST. L’API de traduction de documents Batch traduit des documents dans toutes les langues et dialectes pris en charge tout en préservant la structure des documents et le format des données. Les méthodes disponibles sont répertoriées dans les tableaux suivants :

Version de l’API : 2024-05-01

Remarque

• La version actuelle est rétrocompatible avec la version héritée.

• Avec cette version actuelle et les versions ultérieures, la get supported storage sources méthode n’est plus prise en charge. Translator prend uniquement en charge le stockage Blob Azure.

Requête	Méthode	Description	Chemin d’accès de l’API
Unique	Synchrone	Document	Traduction
Traduire un document	POST	Traduisez de façon synchrone un seul document.	{document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date}
Batch	Asynchrone	Documents	Traduction
Démarrer la traduction	POST	Démarrez un travail de traduction de documents par lots.	{document-translation-endpoint}/translator/document/batches?api-version={date}
Obtenir l’état de tous les travaux de traduction	GET	Demandez une liste et l’état des travaux de traduction soumis par l’utilisateur.	{document-translation-endpoint}/translator/document/batches?api-version={date}
Obtenir l’état d’un travail de traduction spécifique	GET	Demandez un résumé de l’état d’un travail de traduction spécifique. La réponse inclut l’état global du travail et l’état des documents traduits dans le cadre de ce travail.	{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}
Obtenir l’état de tous les documents	GET	Demandez l’état de tous les documents dans un travail de traduction.	{document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date}
Obtenir l’état d’un document spécifique	GET	Demandez l’état d’un document spécifique dans un travail.	{document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date}
Annuler la traduction	DELETE	Annulez un travail de traduction de documents en cours de traitement ou mis en file d’attente.	{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}
Obtenir les formats de document pris en charge	GET	Demandez une liste des formats de document pris en charge.	{document-translation-endpoint}/translator/document/formats?api-version={date}&type=document
Obtenir les formats de glossaire pris en charge	GET	Demandez une liste des formats de glossaire pris en charge.	{document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary

Ancien

Remarque

• La version héritée est rétrocompatible avec la version actuelle. Vous pouvez utiliser les opérations de l’une ou l’autre version pour traduire des documents.
• Nous vous recommandons de migrer vos applications vers la version la plus récente pour bénéficier d’une expérience améliorée et de fonctionnalités avancées.

Requête	Méthode	Description	Chemin d’accès de l’API
Unique	Synchrone	Document	Traduction
Traduire un document	POST	Traduisez de façon synchrone un seul document.	{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	Asynchrone	Documents	Traduction
Démarrer la traduction	POST	Démarrez un travail de traduction de documents par lots.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches
Obtenir l’état de tous les travaux de traduction	GET	Demandez une liste et l’état des travaux de traduction soumis par l’utilisateur.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches
Obtenir l’état d’un travail de traduction spécifique	GET	Demandez un résumé de l’état d’un travail de traduction spécifique. La réponse inclut l’état global du travail et l’état des documents traduits dans le cadre de ce travail.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}
Obtenir l’état de tous les documents	GET	Demandez l’état d’un document spécifique dans un travail.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents
Obtenir l’état d’un document spécifique	GET	Demandez l’état d’un document spécifique dans un travail.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId}
Annuler la traduction	DELETE	Annulez un travail de traduction de documents en cours de traitement ou mis en file d’attente.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}
Obtenir les formats de document pris en charge	GET	Demandez une liste des formats de document pris en charge.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats
Obtenir les formats de glossaire pris en charge	GET	Demandez une liste des formats de glossaire pris en charge.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats
Obtenir les sources de stockage prises en charge	GET	Demandez la liste des sources/options de stockage prises en charge. Actuellement, Translator prend uniquement en charge le stockage Blob Azure.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources

Explorez nos bibliothèques clientes et nos kits SDK pour les langages de programmation C# et Python..