Toplu çeviriyi başlatma

Başvuru
Özelliği: Azure AI Translator → Belge Çevirisi
API'si 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.

İstek URL’si

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

İstek üst bilgileri

İstek üst bilgileri şunlardır:

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.xlf",
              "format": "XLIFF",
              "version": "2.0",
              "storageSource": "AzureBlob"
            }
          ],
          "storageSource": "AzureBlob"
        }
      ],
      "storageType": "Folder"
    }
  ],
}

Girişler

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

inputs.source

Kaynak verilerin tanımı.

inputs.targets

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

inputs.storageType

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

Seçenekler

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

Örnek istek

Toplu istek örnekleri aşağıda 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"
                }
            ]
        }
    ]
}

• İş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.

Yanıt durum kodları

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

Hata yanıtı

Ö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.