Avviare una traduzione batch asincrona

Inviare uno o più documenti archiviati in Archiviazione BLOB di Azure per la traduzione asincrona. Il servizio restituisce un'intestazione operation-location contenente l'ID processo, usato per eseguire il polling dello stato. Ogni contenitore di destinazione in un batch deve essere univoco; L'invio di documenti a un contenitore di destinazione che ha già tradotto l'output causa un errore di conflitto di file. targetUrl Usare per un contenitore specifico, non per una destinazione condivisa.

Metodo HTTP: VERSIONE API POST : 2026-03-01

Richiedi

POST {endpoint}/translator/document/batches?api-version=2026-03-01

Header di richiesta

Intestazione Obbligatorio Description
Ocp-Apim-Subscription-Key Sì La chiave della risorsa Translator dal portale di Azure.
Ocp-Apim-Subscription-Region Condizionale Obbligatorio se si usa una risorsa a livello di area.
Content-Type Sì application/json

Corpo della richiesta

Campo Obbligatorio Description
inputs Sì Matrice di oggetti di input batch. Ogni oggetto definisce un'origine e una o più destinazioni di conversione.
inputs[].source Sì Percorso del documento di origine.
inputs[].source.sourceUrl Sì URL della firma di accesso condiviso per il contenitore o il file di gestione rete virtuale di Azure di origine.
inputs[].source.language No Codice lingua di origine (ad esempio, en). Se omesso, il servizio rileva automaticamente la lingua.
inputs[].source.filter No Oggetto filtro file con prefix i campi e suffix per limitare i file di origine inclusi.
inputs[].targets Sì Matrice di destinazioni di conversione.
inputs[].targets[].targetUrl Sì URL della firma di accesso condiviso per il contenitore gestione rete virtuale di Azure di destinazione. Deve essere univoco in tutti gli input nella richiesta.
inputs[].targets[].language Sì Codice lingua di destinazione (ad esempio, fr).
inputs[].targets[].glossaries No Matrice di oggetti di glossario. Ogni glossario richiede glossaryUrl (URL di firma di accesso condiviso) e format (ad esempio, TSV).
inputs[].storageType No Tipo di origine di archiviazione. Valori supportati: Folder (impostazione predefinita), File.
translateTextWithinImage No Booleano. Impostare su per true tradurre testo all'interno di immagini in .docx e .pptx file.

Richieste di esempio

Traduzione basata su NMT

curl -X POST "{endpoint}/translator/document/batches?api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "source": {
          "sourceUrl": "https://{storage}.blob.core.windows.net/source?{sas}"
        },
        "targets": [
          {
            "targetUrl": "https://{storage}.blob.core.windows.net/target-fr?{sas}",
            "language": "fr"
          }
        ]
      }
    ]
  }'

Più lingue di destinazione

curl -X POST "{endpoint}/translator/document/batches?api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "source": {
          "sourceUrl": "https://{storage}.blob.core.windows.net/source?{sas}"
        },
        "targets": [
          {
            "targetUrl": "https://{storage}.blob.core.windows.net/target-es?{sas}",
            "language": "es"
          },
          {
            "targetUrl": "https://{storage}.blob.core.windows.net/target-ja?{sas}",
            "language": "ja"
          }
        ]
      }
    ]
  }'

Traduzione con glossario

curl -X POST "{endpoint}/translator/document/batches?api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "source": {
          "sourceUrl": "https://{storage}.blob.core.windows.net/source?{sas}"
        },
        "targets": [
          {
            "targetUrl": "https://{storage}.blob.core.windows.net/target-pt?{sas}",
            "language": "pt",
            "glossaries": [
              {
                "glossaryUrl": "https://{storage}.blob.core.windows.net/glossaries/terms.tsv?{sas}",
                "format": "TSV"
              }
            ]
          }
        ]
      }
    ]
  }'

Tradurre immagini in documenti Word e PowerPoint

curl -X POST "{endpoint}/translator/document/batches?api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      {
        "source": {
          "sourceUrl": "https://{storage}.blob.core.windows.net/source?{sas}"
        },
        "targets": [
          {
            "targetUrl": "https://{storage}.blob.core.windows.net/target-ko?{sas}",
            "language": "ko"
          }
        ],
        "translateTextWithinImage": true
      }
    ]
  }'

Risposta

Codici di stato della risposta

Codice di stato Description
202 Accettato. Il processo batch è stato accodato correttamente.
400 Richiesta non valida. Controllare il corpo della richiesta per i campi mancanti o non validi.
401 Autenticazione non riuscita. Controllare la chiave di sottoscrizione.
429 Troppe richieste. Ridurre la frequenza delle richieste.
500 Errore interno del server.

Intestazioni di risposta

Intestazione Description
operation-location URL contenente l'ID processo per il polling. Formato: {endpoint}/translator/document/batches/{jobId}?api-version=2026-03-01.

Contenuti correlati

  • Last updated on