동기 변환 REST API 가이드
참조
서비스: Azure AI 문서 번역
API 버전: v1.1
단일 문서를 동기적으로 번역합니다.
요청 URL
POST
:
curl -i -X POST "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2023-11-01-preview" -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 버전입니다. 현재 값은 .입니다 2023-11-01-preview . |
targetLanguage | 필수 매개 변수입니다. 출력 문서의 언어를 지정합니다. 대상 언어는 번역 범위에 포함된 지원되는 언어 중 하나여야 합니다. |
• 문서= • type= |
필수 매개 변수입니다. • 원본 문서 및 파일 형식 형식의 파일 위치에 대한 경로입니다. • 예: "document=@C:\Test\Test-file.txt; type=text/html |
--출력 | 필수 매개 변수입니다. • 대상 파일 위치의 파일 경로입니다. 번역된 파일이 출력 파일에 인쇄됩니다. • 예: "C:\Test\Test-file-output.txt". 파일 확장명은 원본 파일과 동일해야 합니다. |
선택적 매개 변수
쿼리 매개 변수 | 설명 |
---|---|
sourceLanguage | 입력 문서의 언어를 지정합니다. sourceLanguage 매개 변수를 지정하지 않으면 자동 언어 검색이 적용되어 원본 언어를 결정합니다. |
• 용어집= • type= |
• 사용자 지정 용어집 및 파일 형식 형식의 파일 위치 경로입니다. • 예:"용어집=@D:\Test\SDT\test-simple-glossary.csv; type=text/csv |
allowFallback | • 사용자 지정 시스템이 없을 때 서비스가 시스템으로 대체 generalnn 되도록 지정하는 부울입니다. 가능한 값은 true (기본값) 또는 false 입니다. • allowFallback=false 번역은 요청에 지정된 범주에 대해 학습된 시스템만 사용하도록 지정합니다.• 특정 범주를 가진 시스템을 찾을 수 없는 경우 요청은 400 상태 코드를 반환합니다. • allowFallback=true 사용자 지정 시스템이 없을 때 서비스가 시스템으로 대체되도록 generalnn 허용하도록 지정합니다. |
요청 본문
이름 | 설명 | 콘텐츠 유형 | 조건 |
---|---|---|---|
document | 번역할 원본 문서입니다. | 지원되는 문서 형식 중 하나입니다. | Required |
용어 | 번역 프로세스 중에 사용할 정의가 포함된 용어 목록을 포함하는 문서입니다. | 지원되는 용어집 형식 중 하나입니다. | 선택 사항 |