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.

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 finden contentTypeSie 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

Weitere Informationen zur synchronen Dokumentübersetzung