Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ü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 --requestPOST |
Das Flag „-X“ gibt die Anforderungsmethode für den Zugriff auf die API an. | Erforderlich |
{endpoint} |
Die URL für den Endpunkt der Ressource zur 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, der den Dokumentübersetzungsressourcenschlüssel angibt, 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 contentTypefinden Sie unterUnterstützte Dokumentformate.
Codebeispiel: Dokumentübersetzung
Hinweis
- Jedes Beispiel wird für das
localhostmit demdocker compose upBefehl angegebene Beispiel ausgeführt. - Zeigt während der Ausführung
localhostdes Containers auf den Container selbst. - Sie müssen nicht verwenden
localhost:5000. Sie können jeden Port verwenden, der noch nicht in Ihrer Hostumgebung 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 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 OKzurück, der anzeigt, dass der Dienst die Anforderung erstellt hat.