일괄 처리 번역 시작

참조
기능: Azure AI 번역기 → 문서 번역
API 버전: 2024-05-01
HTTP 메서드: POST

• 메서드를 Start Translation 사용하여 비동기 일괄 처리 변환 요청을 실행합니다.
• 이 방법을 사용하려면 원본 및 번역된 문서에 대한 스토리지 컨테이너가 있는 Azure Blob Storage 계정이 필요합니다.

요청 URL

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

요청 헤더

요청 헤더는 다음과 같습니다.

BatchRequest(본문)

• 개별 요청에 여러 문서가 포함될 수 있으며 각 문서에 대한 원본 및 대상 컨테이너가 포함되어야 합니다. 원본 미디어 유형: application/json, text/json, application/*+json.

• 접두사 및 접미사 필터(제공된 경우)는 폴더를 필터링하는 데 사용됩니다. 접두사는 컨테이너 이름 뒤의 하위 경로에 적용됩니다.

• 요청에 용어집을 포함할 수 있습니다. 용어집이 잘못되었거나 번역 중에 연결할 수 없는 경우 문서 상태에 오류가 표시됩니다.

• 이름이 같은 파일이 대상 대상에 이미 있으면 작업이 실패합니다.

• 각 대상 언어에 대한 targetUrl은 고유해야 합니다.

{
  "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"
    }
  ],
}

입력

입력 일괄 처리 변환 요청에 대한 정의입니다.

inputs.source

원본 데이터에 대한 정의입니다.

inputs.targets

대상 및 용어집 데이터에 대한 정의입니다.

inputs.storageType

입력 문서에 대한 스토리지 엔터티의 정의입니다.

옵션

입력 일괄 처리 변환 요청에 대한 정의입니다.

예제 요청

다음은 일괄 처리 요청의 예입니다.

컨테이너의 모든 문서 번역

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

용어집을 적용하는 컨테이너의 모든 문서 번역

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

                }
            ]
        }
    ]
}

컨테이너의 특정 폴더 번역

폴더 이름(대/소문자 구분)을 필터의 접두사로 지정해야 합니다.

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

컨테이너에서 특정 문서 번역

• "storageType"을 지정합니다 File.
• 특정 Blob/문서에 대한 원본 URL 및 SAS 토큰을 만듭니다.
• SAS 토큰은 컨테이너용이지만 대상 파일 이름을 대상 URL의 일부로 지정합니다.

이 샘플 요청은 두 개의 대상 언어로 번역된 단일 문서를 보여 줍니다.

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

• POST start-batch-translation 메서드 응답 헤더 Operation-Location URL 값에서 작업 id를 찾을 수 있습니다. /document/ 매개 변수 다음의 영숫자 문자열은 작업의 작업 id입니다.

  응답 헤더	응답 URL
  Operation-Location	{document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec?api-version=2024-05-01

• get-translations-status 요청을 사용하여 번역 작업 및 해당 작업 목록을 검색할 수도 있습니다id.

응답 상태 코드

요청을 반환하는 가능한 HTTP 상태 코드는 다음과 같습니다.

오류 응답

오류 응답 예

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

다음 단계

빠른 시작에 따라 문서 번역 및 클라이언트 라이브러리 사용에 대해 자세히 알아보세요.