Démarrer la traduction par lots

Référence
Fonctionnalité : Azure Translator →
Version de l’API traduction de documents (GA) : version d’API 2024-05-01
(préversion) : 2025-12-01-preview , ajoute la prise en charge de la traduction de fichiers image.
Méthode HTTP : POST

• Utilisez la Start Translation méthode pour exécuter une demande de traduction par lots asynchrone.
• La méthode nécessite un compte de stockage Blob Azure avec des conteneurs de stockage pour vos documents sources et traduits.

URL de la requête

  curl -i -X POST "{document-translation-endpoint}/translator/document/batches?api-version={date}"

En-têtes de requête

Les en-têtes de requête sont les suivants :

BatchRequest (corps)

• Chaque requête peut contenir plusieurs documents et doit contenir un conteneur source et un conteneur cible pour chaque document. Types de médias sources : application/json, text/json, application/*+json.

• Les filtres de préfixe et de suffixe (s’ils sont fournis) sont utilisés pour filtrer les dossiers. Le préfixe est appliqué au sous-chemin après le nom du conteneur.

• Les glossaires peuvent être inclus dans la demande. Si le glossaire n’est pas valide ou est inaccessible lors de la traduction, une erreur est signalée dans l’état du document.

• Si un fichier portant le même nom existe déjà dans la destination cible, le travail échoue.

• La valeur targetUrl de chaque langue cible doit être unique.

{
  "inputs": [
    {
      "source": {
        "sourceUrl": "https://myblob.blob.core.windows.net/Container/",
        "filter": {
          "prefix": "FolderA",
          "suffix": ".txt"
        },
        "language": "en",
        "storageSource": "AzureBlob"
      },
      "targets": [
        {
          "targetUrl": "https://myblob.blob.core.windows.net/TargetUrl/",
          "category": "general",
          "language": "fr",
          "glossaries": [
            {
              "glossaryUrl": "https://myblob.blob.core.windows.net/Container/myglossary.xlf",
              "format": "XLIFF",
              "version": "2.0",
              "storageSource": "AzureBlob"
            }
          ],
          "storageSource": "AzureBlob"
        }
      ],
      "storageType": "Folder"
    }
  ],
}

Entrées

Définition de la demande de traduction par lot d’entrée.

inputs.source

Définition des données sources.

inputs.targets

Définition des données des cibles et des glossaires.

inputs.storageType

Définition de l’entité de stockage pour les documents d’entrée.

Paramètres

Définition de la demande de traduction par lot d’entrée.

Exemple de requête

Voici des exemples de demandes de lots :

Traduire tous les documents dans un conteneur

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?{SAS-token-query-string}"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?{SAS-token-query-string}",
                    "language": "fr"
                }
            ]
        }
    ]
}

Traduire un document spécifique dans un conteneur

• Spécifiez « storageType » : File.
• Créez l’URL source et le jeton SAS pour l’objet blob/document spécifique.
• Spécifiez le nom de fichier cible dans le cadre de l’URL cible, bien que le jeton SAS soit toujours pour le conteneur.

Cet exemple de requête montre un document unique traduit en deux langues cibles.

{
    "inputs": [
        {
            "storageType": "File",
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en/source-english.docx?{SAS-token-query-string}"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target/try/Target-Spanish.docx?{SAS-token-query-string}",
                    "language": "es"
                },
                {
                    "targetUrl": "https://my.blob.core.windows.net/target/try/Target-German.docx?{SAS-token-query-string}",
                    "language": "de"
                }
            ]
        }
    ]
}

• L’id de travail se trouve dans la valeur d’URL start-batch-translation de l’en-tête de réponse de la méthode Operation-Location POST. La chaîne alphanumérique qui suit le paramètre /document/ est l’id de travail de l’opération :

  En-tête de réponse	URL de réponse
  Opération-Emplacement	{document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec ?api-version=2024-05-01

• Vous pouvez également utiliser une demande get-translation-status pour récupérer une liste de travaux de traduction et leurs ids.

Traduire tous les documents dans un conteneur appliquant des glossaires

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?{SAS-token-query-string}"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?{SAS-token-query-string}",
                    "language": "fr",
                    "glossaries": [
                        {
                            "glossaryUrl": "https://my.blob.core.windows.net/glossaries/en-fr.xlf?{SAS-token-query-string}",
                            "format": "xliff",
                            "version": "1.2"
                        }
                    ]

                }
            ]
        }
    ]
}

Traduire un dossier spécifique dans un conteneur

Veillez à spécifier le nom du dossier (respectant la casse) comme préfixe dans le filtre.

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?{SAS-token-query-string}",
                "filter": {
                    "prefix": "MyFolder/"
                }
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?{SAS-token-query-string}",
                    "language": "fr"
                }
            ]
        }
    ]
}

Traduire des fichiers image

Configuration de la demande (fichiers image)

Pour la traduction de fichiers image, envoyez votre image via un appel d’API REST de traduction de documents par lots standard, en spécifiant la version d’API 2025-12-01-preview. Aucune configuration supplémentaire n'est nécessaire.

Formats pris en charge (fichiers image)

Langues prises en charge (fichiers image)

Pour plus d’informations sur les langues prises en charge, consultezla prise en charge des langues de traduction de documents.

Codes d’état de réponse

Voici les codes d’état HTTP qu’une demande peut retourner.

Réponse d’erreur

Exemple de réponse d’erreur

{
  "error": {
    "code": "ServiceUnavailable",
    "message": "Service is temporary unavailable",
    "innerError": {
      "code": "ServiceTemporaryUnavailable",
      "message": "Service is currently unavailable.  Please try again later"
    }
  }
}

Étapes suivantes

Suivez notre guide de démarrage rapide pour en savoir plus sur l’utilisation de la traduction de documents et de la bibliothèque cliente.