Partage via


Opérations de traduction de documentation

Fonctionnalité de référence
: Traduction de documents azure AI Translator →

Traduction de documentation est une fonctionnalité basée sur le cloud du service Azure AI Traducteur qui fait partie de la famille Azure Cognitive Service des API REST. L’API 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.

  • À compter de cette version actuelle, la get supported storage sources méthode n’est plus prise en charge. Le service 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, le service Translator prend uniquement en charge le stockage Blob Azure. {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources