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 |