Starten einer asynchronen Batchübersetzung

Übermitteln Sie mindestens ein in Azure Blob Storage gespeichertes Dokument für eine asynchrone Übersetzung. Der Dienst gibt einen operation-location Header zurück, der die Auftrags-ID enthält, die Sie zum Abrufen des Status verwenden. Jeder Zielcontainer in einem Batch muss eindeutig sein; Das Übermitteln von Dokumenten an einen Zielcontainer, der die Ausgabe bereits übersetzt hat, verursacht einen Dateikonfliktfehler. Verwenden Sie den targetUrl Für einen bestimmten Container, kein freigegebenes Ziel.

HTTP-Methode: POST-API-Version: 2026-03-01

Anforderung

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

Anforderungsheader

Header Erforderlich Description
Ocp-Apim-Subscription-Key Ja Ihr Übersetzer-Ressourcenschlüssel aus dem Azure-Portal.
Ocp-Apim-Subscription-Region Conditional Erforderlich, wenn Sie eine regionale Ressource verwenden.
Content-Type Ja application/json

Anforderungstext

Feld Erforderlich Description
inputs Ja Array von Batcheingabeobjekten. Jedes Objekt definiert eine Quelle und mindestens ein Übersetzungsziel.
inputs[].source Ja Speicherort des Quelldokuments.
inputs[].source.sourceUrl Ja SAS-URL für den Quellcontainer oder die Datei Blob Storage.
inputs[].source.language No Quellcode (z. B en. ). Wenn dieser Parameter weggelassen wird, erkennt der Dienst die Sprache automatisch.
inputs[].source.filter No Dateifilterobjekt mit prefix und suffix Feldern, um einzuschränken, welche Quelldateien enthalten sind.
inputs[].targets Ja Array von Übersetzungszielen.
inputs[].targets[].targetUrl Ja SAS-URL für den Zielcontainer Blob Storage. Muss für alle Eingaben in der Anforderung eindeutig sein.
inputs[].targets[].language Ja Zielsprachencode (z. B fr. ).
inputs[].targets[].glossaries No Array von Glossarobjekten. Jedes Glossar erfordert glossaryUrl (SAS-URL) und format (z. B TSV. ).
inputs[].storageType No Speicherquelltyp. Unterstützte Werte: Folder (Standard), File.
translateTextWithinImage No Boolesch. Legen Sie fest, dass true Text in Bildern und .pptx.docx Dateien übersetzt werden soll.

Beispielanforderungen

NMT-basierte Übersetzung

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"
          }
        ]
      }
    ]
  }'

Mehrere Zielsprachen

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"
          }
        ]
      }
    ]
  }'

Übersetzung mit Glossar

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"
              }
            ]
          }
        ]
      }
    ]
  }'

Übersetzen von Bildern in Word- und PowerPoint-Dokumenten

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
      }
    ]
  }'

Antwort

Antwortstatuscodes

Statuscode Description
202 Accepted. Der Batchauftrag wurde erfolgreich in die Warteschlange gestellt.
400 Ungültige Anforderung. Überprüfen Sie den Anforderungstext auf fehlende oder ungültige Felder.
401 Fehler bei der Authentifizierung: Überprüfen Sie Ihren Abonnementschlüssel.
429 Zu viele Anforderungen. Verringern Sie die Anforderungshäufigkeit.
500 Interner Serverfehler.

Antwortkopfzeilen

Header Description
operation-location URL, die die Auftrags-ID für die Abfrage enthält. Format: {endpoint}/translator/document/batches/{jobId}?api-version=2026-03-01.

Verwandte Inhalte

  • Last updated on