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
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 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 OKzurück, der anzeigt, dass der Dienst die Anforderung erstellt hat.