Container: Översätta dokument

Ö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