Toplu çeviriyi başlatma

Makale
06/01/2024

Başvuru
Özelliği: Azure AI Çeviri → Belge Çevirisi
API Sürümü: 2024-05-01
HTTP yöntemi: POST

Start Translation Zaman uyumsuz bir toplu çeviri isteği yürütmek için yöntemini kullanın.
yöntemi, kaynağınız ve çevrilmiş belgeleriniz için depolama kapsayıcılarına sahip bir Azure Blob depolama hesabı gerektirir.

İpucu

Bu yöntem get-translation-status, get-documents-status, get-document-status ve cancel-translation istek sorgu dizeleri için iş id parametresini döndürür.

İşi id POST start-batch-translation yöntemi yanıt Üst Bilgi Operation-Location URL'si değerinde bulabilirsiniz. parametresini /document/ izleyen alfasayısal dize, işlemin işidir id:

Yanıt üst bilgisi	Yanıt URL'si
İşlem Konumu	{document-translation-endpoint}/translator/document/`9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec`?api-version=2024-05-01

Çeviri işlerinin ve işlerinin idlistesini almak için get-translations-status isteği de kullanabilirsiniz.

İstek URL’si

Önemli

Belge Çevirisi özelliğine yönelik tüm API istekleri, Azure portalındaki kaynağınıza genel bakış sayfasında bulunan özel bir etki alanı uç noktası gerektirir.

  curl -i -X POST "{document-translation-endpoint}/translator/document/batches?api-version={date}"

İstek üst bilgileri

İstek üst bilgileri şunlardır:

Üst Bilgiler	Açıklama	Koşul
Ocp-Apim-Subscription-Key	Azure portalından Çeviri hizmet API anahtarınız.	Zorunlu
Ocp-Apim-Subscription-Region	Kaynağınızın oluşturulduğu bölge.	• Batı ABD gibi bölgesel (coğrafi) bir kaynak kullanılırken gereklidir. & madde işareti.
İçerik Türü	Yükün içerik türü. Kabul edilen değer application/json veya charset=UTF-8'dir.	• Gerekli

BatchRequest (gövde)

Her istek birden çok belge içerebilir ve her belge için bir kaynak ve hedef kapsayıcı içermelidir. Kaynak medya türleri: application/json, text/json, application/*+json.
Klasörleri filtrelemek için ön ek ve sonek filtresi (sağlandıysa) kullanılır. Ön ek, kapsayıcı adından sonra alt yol için uygulanır.
Sözlükler isteğe dahil edilebilir. Çeviri sırasında sözlük geçersizse veya ulaşılamıyorsa, belge durumunda bir hata gösterilir.
Hedef hedefte aynı ada sahip bir dosya zaten varsa, iş başarısız olur.
Her hedef dil için targetUrl benzersiz olmalıdır.


{
  "inputs": [
    {
      "source": {
        "sourceUrl": "https://myblob.blob.core.windows.net/Container/",
        "filter": {
          "prefix": "FolderA",
          "suffix": ".txt"
        },
        "language": "en",
        "storageSource": "AzureBlob"
      },
      "targets": [
        {
          "targetUrl": "https://myblob.blob.core.windows.net/TargetUrl/",
          "category": "general",
          "language": "fr",
          "glossaries": [
            {
              "glossaryUrl": "https://myblob.blob.core.windows.net/Container/myglossary.tsv",
              "format": "XLIFF",
              "version": "2.0",
              "storageSource": "AzureBlob"
            }
          ],
          "storageSource": "AzureBlob"
        }
      ],
      "storageType": "Folder"
    }
  ],
  "options": {
    "experimental": true
  }
}

Girişler

Giriş toplu çevirisi isteğinin tanımı.

Anahtar parametresi	Type	Zorunlu	İstek parametreleri	Açıklama
Giriş	`array`	True	• kaynak (nesne) • hedefler (dizi) • storageType (dize)	Giriş kaynağı verileri.

inputs.source

Kaynak verilerin tanımı.

Anahtar parametresi	Type	Zorunlu	İstek parametreleri	Açıklama
inputs.source	`object`	True	• sourceUrl (dize) • filtre (nesne) • dil (dize) • storageSource (dize)	Giriş belgeleri için kaynak veriler.
inputs.source.sourceUrl	`string`	True	•Dize	Kaynak dosya veya klasör için kapsayıcı konumu.
inputs.source.filter	`object`	False	• ön ek (dize) • sonek (dize)	Kaynak yoldaki belgeleri filtrelemek için büyük/küçük harfe duyarlı dizeler.
inputs.source.filter.prefix	`string`	False	•Dize	Çeviri için kaynak yoldaki belgeleri filtrelemek için büyük/küçük harfe duyarlı ön ek dizesi. Genellikle alt klasörleri çeviri için tanımlamak için kullanılır. Örnek: "FolderA".
inputs.source.filter.suffix	`string`	False	•Dize	Çeviri için kaynak yoldaki belgeleri filtrelemek için büyük/küçük harfe duyarlı sonek dizesi. En sık dosya uzantıları için kullanılır. Örnek: ".txt"
inputs.source.language	`string`	False	•Dize	Kaynak belgelerin dil kodu. Belirtilmezse, otomatik algılama uygulanır.
inputs.source.storageSource	`string`	False	•Dize	Girişler için Depolama kaynak. varsayılan değeridir `AzureBlob`.

inputs.targets

Hedef ve sözlük verilerinin tanımı.

Anahtar parametresi	Type	Zorunlu	İstek parametreleri	Açıklama
inputs.targets	`array`	True	• targetUrl (dize) • kategori (dize) • dil (dize) • sözlükler (dizi) • storageSource (dize)	Çevrilen belgeler için hedefler ve sözlük verileri.
inputs.targets.targetUrl	`string`	True	•Dize	Çevrilen belgeler için kapsayıcı konumunun konumu.
inputs.targets.category	`string`	False	•Dize	Çeviri isteği için sınıflandırma veya kategori. Örnek: genel.
inputs.targets.language	`string`	True	•Dize	Hedef dil kodu. Örnek: "fr".
inputs.targets.glossaries	`array`	False	• glossaryUrl (dize) • biçim (dize) • sürüm (dize) • storageSource (dize)	Bkz.Sözlük oluşturma ve kullanma
inputs.targets.glossaries.glossaryUrl	`string`	True (sözlükler kullanılıyorsa)	•Dize	Sözlüğün konumu. Biçim parametresi sağlanmazsa, biçimlendirmeyi ayıklamak için dosya uzantısı kullanılır. Çeviri dil çifti sözlükte yoksa uygulanmaz.
inputs.targets.glossaries.format	`string`	False	•Dize	Sözlük için belirtilen dosya biçimi. Dosya biçiminizin desteklenip desteklenmediğini denetlemek için bkz. Desteklenen sözlük biçimlerini alma.
inputs.targets.glossaries.version	`string`	False	•Dize	Sürüm göstergesi. Örnek: "2.0".
inputs.targets.glossaries.storageSource	`string`	False	•Dize	Sözlükler için Depolama kaynak. varsayılan değeridir `_AzureBlob_`.
inputs.targets.storageSource	`string`	False	•Dize	targets.defaults `_AzureBlob_`için kaynağı Depolama.

inputs.storageType

Giriş belgeleri için depolama varlığının tanımı.

Anahtar parametresi	Type	Zorunlu	İstek parametreleri	Açıklama
inputs.storageType	`string`	False	•`Folder` • `File`	Giriş belgelerinin kaynak dizesinin türü Depolama. Yalnızca "Klasör" veya "Dosya" geçerli değerlerdir.

Seçenekler

Giriş toplu çevirisi isteğinin tanımı.

Anahtar parametresi	Type	Zorunlu	İstek parametreleri	Açıklama
Seçenekler	`object`	False	Giriş belgeleri için kaynak bilgileri.
options.experimental	`boolean`	False	•`true` • `false`	İsteğin deneysel bir özellik içerip içermediğini gösterir (varsa). Yalnızca boole değerleri `true` veya `false` geçerli değerlerdir.

Örnek istek

Toplu istek örnekleri aşağıda verilmiştir.

Not

Aşağıdaki örneklerde, paylaşılan erişim imzası (SAS) belirteci kullanılarak Azure Depolama kapsayıcısının içeriğine sınırlı erişim verilmiştir.

Kapsayıcıdaki tüm belgeleri çevirme

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?{SAS-token-query-string}"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?{SAS-token-query-string}",
                    "language": "fr"
                }
            ]
        }
    ]
}

Kapsayıcıdaki tüm belgeleri çevirip sözlükler uygulama

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?{SAS-token-query-string}"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?{SAS-token-query-string}",
                    "language": "fr",
                    "glossaries": [
                        {
                            "glossaryUrl": "https://my.blob.core.windows.net/glossaries/en-fr.xlf?{SAS-token-query-string}",
                            "format": "xliff",
                            "version": "1.2"
                        }
                    ]

                }
            ]
        }
    ]
}

Kapsayıcıda belirli bir klasörü çevirme

Filtrede klasör adını (büyük/küçük harfe duyarlı) ön ek olarak belirttiğinizden emin olun.

{
    "inputs": [
        {
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en?{SAS-token-query-string}",
                "filter": {
                    "prefix": "MyFolder/"
                }
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target-fr?{SAS-token-query-string}",
                    "language": "fr"
                }
            ]
        }
    ]
}

Kapsayıcıda belirli bir belgeyi çevirme

"storageType" değerini belirtin: File.
Belirli bir blob/belge için kaynak URL ve SAS belirteci oluşturun.
HEDEF URL'nin bir parçası olarak hedef dosya adını belirtin; sas belirteci kapsayıcı için hala geçerli olsa da.

Bu örnek istek, iki hedef dile çevrilmiş tek bir belgeyi gösterir.

{
    "inputs": [
        {
            "storageType": "File",
            "source": {
                "sourceUrl": "https://my.blob.core.windows.net/source-en/source-english.docx?{SAS-token-query-string}"
            },
            "targets": [
                {
                    "targetUrl": "https://my.blob.core.windows.net/target/try/Target-Spanish.docx?{SAS-token-query-string}",
                    "language": "es"
                },
                {
                    "targetUrl": "https://my.blob.core.windows.net/target/try/Target-German.docx?{SAS-token-query-string}",
                    "language": "de"
                }
            ]
        }
    ]
}

Yanıt durum kodları

Bir isteğin döndürdüğü olası HTTP durum kodları aşağıdadır.

Durum Kodu	Açıklama
202	Kabul. Başarılı istek ve toplu iş isteği oluşturuldu. Operation-Location üst bilgisi id.HeadersOperation-Location: dize işlemini içeren bir durum URL'sini gösterir
400	Hatalı İstek. Geçersiz istek. Giriş parametrelerini denetleyin.
Kategori 401	Yetkisiz. Kimlik bilgilerinizi denetleyin.
Kategori 429	İstek oranı çok yüksek.
500	İç Sunucu Hatası.
503	Hizmet şu anda kullanılamıyor. Daha sonra tekrar deneyin.
Diğer Durum Kodları	• Çok fazla istek var. Sunucu geçici olarak kullanılamıyor

Hata yanıtı

Anahtar parametresi	Type	Açıklama
kod	`string`	Üst düzey hata kodları içeren sabit listeleri. Olası değerler:</br/>• InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable • Yetkisiz
ileti	`string`	Üst düzey hata iletisi alır.
innerError	InnerTranslationError	Azure AI hizmetleri API Yönergelerine uygun yeni İç Hata biçimi. Bu hata iletisi gerekli özellikleri içerir: ErrorCode, ileti ve isteğe bağlı özellikler hedefi, ayrıntılar (anahtar değer çifti) ve iç hata (iç içe yerleştirilebilir).
Iç. Hata kodu	`string`	Kod hata dizesini alır.
innerError.message	`string`	Üst düzey hata iletisi alır.
innerError.target	`string`	Hatanın kaynağını alır. Örneğin, belgenin geçersiz olması veya `document id` olması `documents` gerekir.

Örnek hata yanıtı

{
  "error": {
    "code": "ServiceUnavailable",
    "message": "Service is temporary unavailable",
    "innerError": {
      "code": "ServiceTemporaryUnavailable",
      "message": "Service is currently unavailable.  Please try again later"
    }
  }
}

Sonraki adımlar

Belge Çevirisi ve istemci kitaplığını kullanma hakkında daha fazla bilgi edinmek için hızlı başlangıcımızı izleyin.

Belge Çevirisi ile çalışmaya başlama

Aracılığıyla paylaş