Kontejner: Překlad dokumentů
Přeloží dokument se zadaným zdrojovým jazykem.
Adresa URL požadavku (pomocí cURL)
POST prosba:
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}"
Příklad:
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"
Synchronní hlavičky a parametry požadavků
Pomocí synchronního zpracování překladu odešlete dokument jako součást textu požadavku HTTP a obdržíte přeložený dokument v odpovědi HTTP.
| Parametr dotazu | Popis | Podmínka |
|---|---|---|
-X nebo --request POST |
Příznak -X určuje metodu požadavku pro přístup k rozhraní API. | Povinní účastníci |
{endpoint} |
Adresa URL koncového bodu prostředku překladu dokumentů | Povinní účastníci |
targetLanguage |
Určuje jazyk výstupního dokumentu. Cílový jazyk musí být jedním z podporovaných jazyků zahrnutých v oboru překladu. | Povinní účastníci |
sourceLanguage |
Určuje jazyk vstupního dokumentu. sourceLanguage Pokud parametr není zadaný, použije se automatické rozpoznávání jazyka k určení zdrojového jazyka. |
Volitelné |
-H nebo --header "Ocp-Apim-Subscription-Key:{KEY} |
Hlavička požadavku, která určuje klíč prostředku překladu dokumentů, který autorizuje přístup k rozhraní API. | Povinní účastníci |
-F nebo --form |
Cesta k souboru dokumentu, který chcete zahrnout do žádosti. Je povolený jenom jeden zdrojový dokument. | Povinní účastníci |
• document=• type={contentType}/fileExtension |
• Cesta k umístění souboru pro zdrojový dokument. • Typ obsahu a přípona souboru. Příklad: "document=@C:\Test\test-file.md; type=text/markdown" |
Povinní účastníci |
-o nebo --output |
Cesta k souboru výsledkům odpovědi. | Povinní účastníci |
-F nebo --form |
Cesta k souboru k volitelnému glosáři, který se má zahrnout do vaší žádosti. Glosář vyžaduje samostatný --form příznak. |
Volitelné |
• glossary=• type={contentType}/fileExtension |
• Cesta k umístění souboru pro volitelný soubor glosáře. • Typ obsahu a přípona souboru. Příklad: "glosář=@C:\Test\glossary-file.txt; type=text/plain |
Volitelné |
✔️ Další informace naleznete contentTypev tématu Podporované formáty dokumentů.
Ukázka kódu: překlad dokumentu
Poznámka:
- Každá ukázka se spustí na
localhostzadanémdocker compose uppříkazu. - Zatímco je kontejner spuštěný,
localhostodkazuje na samotný kontejner. - Nemusíte používat
localhost:5000. V hostitelském prostředí můžete použít libovolný port, který se ještě nepoužívá.
Ukázkový dokument
Pro tento projekt potřebujete zdrojový dokument k překladu. Můžete si stáhnout ukázkový dokument překladu dokumentů a uložit ho do stejné složky jako váš compose.yaml soubor (container-environment). Název souboru je document-translation-sample.docx a zdrojový jazyk je angličtina.
Dotazování koncového bodu Azure AI Translatoru (dokument)
Tady je příklad požadavku HTTP cURL pomocí 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"
Po úspěšném dokončení:
- Přeložený dokument se vrátí s odpovědí.
- Úspěšná metoda POST vrátí
200 OKkód odpovědi označující, že služba vytvořila požadavek.