Kapsayıcı: Belgeleri Çevir (önizleme)

Önemli

• Azure AI Çeviri genel önizleme sürümleri, etkin geliştirme aşamasında olan özelliklere erken erişim sağlar.
• Genel Kullanılabilirlik (GA) öncesinde kullanıcı geri bildirimlerine göre özellikler, yaklaşımlar ve süreçler değişebilir.

Belgeyi belirtilen kaynak dille çevirin.

İstek URL'si (cURL kullanarak)

POST Istek:

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

Örnek:

curl -i -X POST "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2023-11-01-preview" -F "document=@C:\Test\test-file.md;type=text/markdown" -o "C:\translation\translated-file.md"

Zaman uyumlu istek üst bilgileri ve parametreleri

HTTP isteği gövdesinin bir parçası olarak belge göndermek ve çevrilen belgeyi HTTP yanıtında almak için zaman uyumlu çeviri işlemeyi kullanın.

Sorgu parametresi	Açıklama	Koşul
-X veya --requestPOST	-X bayrağı, API'ye erişmek için istek yöntemini belirtir.	Required
{endpoint}	Belge Çevirisi kaynak uç noktanızın URL'si	Required
targetLanguage	Çıktı belgesinin dilini belirtir. Hedef dil, çeviri kapsamına dahil edilen desteklenen dillerden biri olmalıdır.	Required
sourceLanguage	Giriş belgesinin dilini belirtir. sourceLanguage Parametresi belirtilmezse, kaynak dili belirlemek için otomatik dil algılama uygulanır.	Optional
-H veya --header"Ocp-Apim-Subscription-Key:{KEY}	API'ye erişim yetkisi veren Belge Çevirisi kaynak anahtarını belirten istek üst bilgisi.	Required
-F veya --form	İsteğinize eklemek istediğiniz belgenin dosya yolu. Yalnızca bir kaynak belgeye izin verilir.	Required
• document= • type={contentType}/fileExtension	• Kaynak belgenizin dosya konumunun yolu. • İçerik türü ve dosya uzantısı. Örneğin: "document=@C:\Test\test-file.md; type=text/markdown"	Required
-o veya --output	Yanıt sonuçlarının dosya yolu.	Required
-F veya --form	İsteğinize dahil etmek için isteğe bağlı bir sözlüğün dosya yolu. Sözlük ayrı --form bir bayrak gerektirir.	Optional
• glossary= • type={contentType}/fileExtension	• İsteğe bağlı sözlük dosyanızın dosya konumunun yolu. • İçerik türü ve dosya uzantısı. Örneğin: "glossary=@C:\Test\glossary-file.txt; type=text/plain	Optional

✔️ hakkında contentTypedaha fazla bilgi için bkz. Desteklenen belge biçimleri.

Kod örneği: belge çevirisi

Not

• Her örnek, komutuyla docker compose up belirttiğiniz üzerinde localhost çalışır.
• Kapsayıcınız çalışırken kapsayıcının localhost kendisini gösterir.
• kullanmak localhost:5000zorunda değilsiniz. Konak ortamınızda henüz kullanımda olmayan herhangi bir bağlantı noktasını kullanabilirsiniz.

Örnek belge

Bu proje için çevrilecek bir kaynak belge gerekir. için belge çevirisi örnek belgemizi indirebilir ve dosyanızla (container-environment) aynı klasörde depolayabilirsinizcompose.yaml. Dosya adı ve document-translation-sample.docx kaynak dil İngilizce'dir.

Azure AI Çeviri uç noktasını sorgulama (belge)

Aşağıda localhost:5000 kullanan bir cURL HTTP isteği örneği verilmişti:

curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2023-11-01-preview" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"

Başarıyla tamamlandıktan sonra:

• Çevrilen belge yanıtla birlikte döndürülür.
• Başarılı POST yöntemi, hizmetin isteği oluşturduğunu belirten bir 200 OK yanıt kodu döndürür.

Sonraki adımlar

Zaman uyumlu belge çevirisi hakkında daha fazla bilgi edinin