Freigeben über


Container: Dokumente übersetzen

Übersetzen Sie das Dokument mit der angegebenen Quellsprache.

Anforderungs-URL (mit cURL)

POST bitten:

    POST "http://localhost:{port}/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version={api-version}" -F "document=@{path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file-with-file-extension}"

Beispiel:

curl -i -X POST "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2024-05-01" -F "document=@C:\Test\test-file.md;type=text/markdown" -o "C:\translation\translated-file.md"

Synchrone Anforderungsheader und Parameter

Verwenden Sie die synchrone Übersetzungsverarbeitung, um ein Dokument als Teil des HTTP-Anforderungstexts zu senden und das übersetzte Dokument in der HTTP-Antwort zu empfangen.

Query parameter (Abfrageparameter) Beschreibung Bedingung
-X oder --request POST Das Flag „-X“ gibt die Anforderungsmethode für den Zugriff auf die API an. Erforderlich
{endpoint} Die URL für Ihren Ressourcenendpunkt für die Dokumentübersetzung Erforderlich
targetLanguage Gibt die Sprache des Ausgabedokuments an. Die Zielsprache muss eine der unterstützten Sprachen im Übersetzungsbereich sein. Erforderlich
sourceLanguage Gibt die Sprache des Eingabedokuments an. Wenn der Parameter sourceLanguage nicht angegeben ist, wird die automatische Sprachenerkennung zum Bestimmen der Quellsprache verwendet. Optional
-H oder --header "Ocp-Apim-Subscription-Key:{KEY} Anforderungsheader mit dem Dokumentübersetzungs-Ressourcenschlüssel, der den Zugriff auf die API autorisiert. Erforderlich
-F oder --form Der Dateipfad zu dem Dokument, das Sie in Ihre Anforderung einschließen möchten. Es ist nur ein Quelldokument zulässig. Erforderlich
document=
type={contentType}/fileExtension
• Pfad zum Dateispeicherort für Ihr Quelldokument.
• Inhaltstyp und Dateierweiterung.

Beispiel: "document=@C:\Test\test-file.md; type=text/markdown"
Erforderlich
-o oder --output Der Dateipfad zu den Antwortergebnissen. Erforderlich
-F oder --form Der Dateipfad zu einem optionalen Glossar, das in Ihre Anforderung eingeschlossen werden soll. Das Glossar erfordert ein separates --form-Flag. Optional
glossary=
type={contentType}/fileExtension
• Pfad zum Dateispeicherort für die optionale Glossardatei.
• Inhaltstyp und Dateierweiterung.

Beispiel: "glossary=@C:\Test\Glossardatei.txt;type=text/plain
Optional

✔️ Weitere Informationen zu contentType finden Sie unter Unterstützte Dokumentformate.

Codebeispiel: Dokumentübersetzung

Hinweis

  • Jedes Beispiel wird für das localhost mit dem docker compose up Befehl angegebene Beispiel ausgeführt.
  • Zeigt während der Ausführung localhost des Containers auf den Container selbst.
  • Sie müssen nicht verwenden localhost:5000. Sie können jeden Port verwenden, der in Ihrer Hostumgebung noch nicht verwendet wird.

Beispieldokument

Für dieses Projekt benötigen Sie ein Quelldokument, das übersetzt werden soll. Sie können unser Dokumentübersetzungsbeispieldokument herunterladen und in demselben Ordner wie Ihre compose.yaml Datei (container-environment) speichern. Der Dateiname lautet document-translation-sample.docx , und die Quellsprache ist Englisch.

Azure AI Translator-Endpunkt (Dokument) abfragen

Hier ist ein Beispiel für eine cURL-HTTP-Anforderung mit localhost:5000:

curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2024-05-01" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"

Nach erfolgreichem Abschluss:

  • Das übersetzte Dokument wird mit der Antwort zurückgegeben.
  • Bei erfolgreicher Ausführung gibt die POST-Methode den Antwortcode 200 OK zurück, der anzeigt, dass der Dienst die Anforderung erstellt hat.

Nächste Schritte