Belge Çevirisi işlemleri
Başvuru
Özelliği: Azure AI Translator → Belge Çevirisi
Belge Çevirisi, Azure AI Translator hizmetinin bulut tabanlı bir özelliğidir ve Azure yapay zeka hizmeti rest API'leri ailesinin bir parçasıdır. Toplu Belge Çevirisi API'si, belge yapısını ve veri biçimini korurken belgeleri desteklenen tüm diller ve diyalektler arasında çevirir. Kullanılabilir yöntemler aşağıdaki tablolarda listelenmiştir:
API Sürümü: 2024-05-01
Not
Geçerli sürüm eski sürümle geriye dönük olarak uyumludur.
Bu geçerli sürümden başlayarak yöntemi
get supported storage sourcesartık desteklenmiyor. Translator hizmeti yalnızca Azure Blob depolamayı destekler.
| İstek | Metot | Açıklama | API yolu |
|---|---|---|---|
| Tek | Eşzamanlı | Belge | Çeviri |
| Belgeyi çevir | POST | Tek bir belgeyi zaman uyumlu bir şekilde çevirin. | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| Batch | Eşzamansız | Belgeler | Çeviri |
| Çeviriyi başlatma | POST | Toplu belge çevirisi işi başlatın. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Tüm çeviri işlerinin durumunu alma | GET | Bir liste ve kullanıcı tarafından gönderilen çeviri işlerinin durumunu isteyin. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Belirli bir çeviri işinin durumunu alma | GET | Belirli bir çeviri işinin durumunun özetini isteyin. Yanıt, genel iş durumunu ve bu işin bir parçası olarak çevrilen belgelerin durumunu içerir. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Tüm belgelerin durumunu alma | GET | Çeviri işi içindeki tüm belgelerin durumunu isteyin. | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| Belirli bir belgenin durumunu alma | GET | bir işteki belirli bir belgenin durumunu isteyin. | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| Çeviriyi iptal et | SİL | İşlenen veya kuyruğa alınmış bir belge çevirisi işini iptal edin. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| Desteklenen belge biçimlerini alma | GET | Desteklenen belge biçimlerinin listesini isteyin. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| Desteklenen sözlük biçimlerini alma | GET | Desteklenen sözlük biçimlerinin listesini isteyin. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
Eski
Not
- Eski sürüm, geçerli sürümle geriye dönük olarak uyumludur. Belgeleri çevirmek için herhangi bir sürümün işlemlerini kullanabilirsiniz.
- Gelişmiş deneyim ve gelişmiş özelliklerden yararlanmak için uygulamalarınızı en yeni sürüme geçirmenizi öneririz.
| İstek | Metot | Açıklama | API yolu |
|---|---|---|---|
| Tek | Eşzamanlı | Belge | Çeviri |
| Belgeyi çevir | POST | Tek bir belgeyi zaman uyumlu bir şekilde çevirin. | {document-translation-endpoint}/translator/document:translate?sourceLanguage={source language}&targetLanguage={target language}&api-version=2024-05-01" -H "Ocp-Apim-Subscription-Key:{your-key}" -F "document={path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -F "glossary={path-to-your-glossary-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file}" |
| Batch | Eşzamansız | Belgeler | Çeviri |
| Çeviriyi başlatma | POST | Toplu belge çevirisi işi başlatın. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Tüm çeviri işlerinin durumunu alma | GET | Bir liste ve kullanıcı tarafından gönderilen çeviri işlerinin durumunu isteyin. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| Belirli bir çeviri işinin durumunu alma | GET | Belirli bir çeviri işinin durumunun özetini isteyin. Yanıt, genel iş durumunu ve bu işin bir parçası olarak çevrilen belgelerin durumunu içerir. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Tüm belgelerin durumunu alma | GET | bir işteki belirli bir belgenin durumunu isteyin. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
| Belirli bir belgenin durumunu alma | GET | bir işteki belirli bir belgenin durumunu isteyin. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| Çeviriyi iptal et | SİL | İşlenen veya kuyruğa alınmış bir belge çevirisi işini iptal edin. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| Desteklenen belge biçimlerini alma | GET | Desteklenen belge biçimlerinin listesini isteyin. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
| Desteklenen sözlük biçimlerini alma | GET | Desteklenen sözlük biçimlerinin listesini isteyin. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
| Desteklenen depolama kaynaklarını alma | GET | Desteklenen depolama kaynaklarının/seçeneklerinin listesini isteyin. Şu anda Translator hizmeti yalnızca Azure Blob depolamayı destekler. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |