동기 문서 번역
참조
기능: Azure AI 번역기 → 문서 번역
API 버전: 2024-05-01
HTTP 메서드: POST
- 단일 문서를 동기식으로 번역하려면
translate document메서드를 사용합니다. - 이 메서드에는 Azure Blob Storage 계정이 필요하지 않습니다.
- 최종 응답에는 번역된 문서가 포함되어 있으며 호출 클라이언트에 직접 반환됩니다.
Important
문서 번역 기능에 대한 모든 API 요청에는 Azure Portal의 리소스 개요 페이지에 있는 사용자 지정 도메인 엔드포인트가 필요합니다.
요청 URL
curl -i -X POST "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version={date}" -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}"
요청 헤더
REST API를 통해 동기 번역 기능을 호출하려면 각 요청에 다음 헤더를 포함합니다.
| 헤더 | 값 | 조건 |
|---|---|---|
| Ocp-Apim-Subscription-Key | Azure Portal의 Translator 서비스 키입니다. | • 필수 |
요청 매개 변수
쿼리 문자열 매개 변수:
필수 매개 변수
| 쿼리 매개 변수 | 설명 |
|---|---|
| api-version | 필수 매개 변수입니다. 클라이언트에서 요청한 API 버전입니다. 현재 값은 2024-05-01입니다. |
| targetLanguage | 필수 매개 변수입니다. 출력 문서의 언어를 지정합니다. 대상 언어는 번역 범위에 포함된 지원 언어 중 하나여야 합니다. |
| • document= • type= |
필수 매개 변수. • 원본 문서 및 파일 형식 형식에 대한 파일 위치 경로입니다. • 예: "document=@C:\Test\Test-file.txt;type=text/html |
| --output | 필수 매개 변수입니다. • 대상 파일 위치의 파일 경로. 번역된 파일이 출력 파일에 인쇄됩니다. • 예: "C:\Test\Test-file-output.txt". 파일 확장자는 원본 파일과 동일해야 합니다. |
선택적 매개 변수
| 쿼리 매개 변수 | 설명 |
|---|---|
| sourceLanguage | 입력 문서의 언어를 지정합니다. sourceLanguage 매개 변수를 지정하지 않으면 자동 언어 검색이 적용되어 원본 언어를 결정합니다. |
| • glossary= • type= |
• 사용자 지정 용어집 및 파일 형식 형식에 대한 파일 위치 경로입니다. • 예:"glossary=@D:\Test\SDT\test-simple-glossary.csv;type=text/csv |
| allowFallback | • 사용자 지정 시스템이 존재하지 않을 때 서비스가 generalnn 시스템으로 대체되도록 지정하는 부울입니다. 가능한 값은 true(기본값) 또는 false입니다. • allowFallback=false는 요청에 지정된 범주에 대해 학습된 시스템만 번역에서 사용해야 함을 지정합니다.• 특정 범주를 사용하는 시스템이 없는 경우 요청은 400 상태 코드를 반환합니다. • allowFallback=true는 사용자 지정 시스템이 없을 때 서비스가 generalnn 시스템으로 대체되도록 허용하도록 지정합니다. |
| category | 번역의 범주(도메인)를 지정하는 문자열입니다. 이 매개 변수를 사용하여 Custom Translator로 작성된 사용자 지정 시스템의 번역을 가져옵니다. 배포된 사용자 지정 시스템을 동시 문서 번역에 사용하려면 사용자 지정 번역기 프로젝트 세부 정보에서 Category ID을(를) category 매개변수에 추가하세요. 기본값은 generalnn입니다. |
요청 본문
| 이름 | 설명 | 콘텐츠 유형 | 조건 |
|---|---|---|---|
| document | 번역할 원본 문서입니다. | 지원되는 문서 형식 중 하나입니다. | Required |
| glossary | 번역 과정에서 사용할 정의와 용어 목록이 포함된 문서입니다. | 지원되는 용어집 형식 중 하나입니다. | 선택 사항 |