Dela via

Container: Översätta dokument

  • Artikel

Översätta dokument med angivet källspråk.

Begärande-URL (med cURL)

POST begäran:

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

Exempel:

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"

Synkrona begärandehuvuden och parametrar

Använd synkron översättningsbearbetning för att skicka ett dokument som en del av HTTP-begärandetexten och ta emot det översatta dokumentet i HTTP-svaret.

Frågeparameter beskrivning Villkor
-X eller --request POST Flaggan -X anger begärandemetoden för åtkomst till API:et. Krävs
{endpoint} URL:en för resursslutpunkten för dokumentöversättning Krävs
targetLanguage Anger språket i utdatadokumentet. Målspråket måste vara ett av de språk som stöds i översättningsomfånget. Krävs
sourceLanguage Anger språket för indatadokumentet. Om parametern sourceLanguage inte anges tillämpas automatisk språkidentifiering för att fastställa källspråket. Valfritt
-H eller --header "Ocp-Apim-Subscription-Key:{KEY} Begärandehuvud som anger resursnyckeln för dokumentöversättning som ger åtkomst till API:et. Krävs
-F eller --form Filsökvägen till det dokument som du vill inkludera med din begäran. Endast ett källdokument tillåts. Krävs
• document=
• type={contentType}/fileExtension		 • Sökväg till filplatsen för källdokumentet.
• Innehållstyp och filnamnstillägg.

Exempel: "document=@C:\Test\test-file.md; type=text/markdown"		 Krävs
-o eller --output Filsökvägen till svarsresultatet. Krävs
-F eller --form Filsökvägen till en valfri ordlista som ska inkluderas i din begäran. Ordlistan kräver en separat --form flagga. Valfritt
• glossary=
• type={contentType}/fileExtension		 • Sökväg till filplatsen för din valfria ordlista.
• Innehållstyp och filnamnstillägg.

Exempel: "glossary=@C:\Test\glossary-file.txt; type=text/plain		 Valfritt

✔️ Mer information om contentTypefinns i Dokumentformat som stöds.

Kodexempel: dokumentöversättning

Kommentar

  • Varje exempel körs på det localhost som du angav med docker compose up kommandot .
  • När containern körs localhost pekar den på själva containern.
  • Du behöver inte använda localhost:5000. Du kan använda alla portar som inte redan används i värdmiljön.

Exempeldokument

För det här projektet behöver du ett källdokument för att översätta. Du kan ladda ned vårt exempeldokument för dokumentöversättning för och lagra det i samma mapp som din compose.yaml fil (container-environment). Filnamnet är document-translation-sample.docx och källspråket är engelska.

Fråga Azure AI Translator-slutpunkten (dokument)

Här är ett exempel på en cURL HTTP-begäran med 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"

När det har slutförts:

  • Det översatta dokumentet returneras med svaret.
  • Post-metoden returnerar en 200 OK svarskod som anger att tjänsten skapade begäran.

Nästa steg

Läs mer om synkron dokumentöversättning