컨테이너: 문서 번역(미리 보기)
Important
- Azure AI 번역기 공개 미리 보기 릴리스는 활성 개발 중인 기능에 대한 초기 액세스를 제공합니다.
- 기능, 방식 및 프로세스는 GA(일반 공급) 전에 사용자 피드백에 따라 변경될 수 있습니다.
원본 언어가 지정된 문서를 번역합니다.
요청 URL(cURL 사용)
POST
요청:
POST "http://localhost:{port}/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version={api-version}" -F "document=@{path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file-with-file-extension}"
예시:
curl -i -X POST "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2023-11-01-preview" -F "document=@C:\Test\test-file.md;type=text/markdown" -o "C:\translation\translated-file.md"
동기 요청 헤더 및 매개 변수
동기식 번역 처리를 사용하여 HTTP 요청 본문의 일부로 문서를 보내고 HTTP 응답에서 번역된 문서를 받습니다.
쿼리 매개 변수 | 설명 | 조건 |
---|---|---|
-X 또는 --request POST |
-X 플래그는 API에 액세스할 요청 메서드를 지정합니다. | Required |
{endpoint} |
문서 번역 리소스 엔드포인트의 URL | Required |
targetLanguage |
출력 문서의 언어를 지정합니다. 대상 언어는 번역 범위에 포함된 지원되는 언어 중 하나여야 합니다. | Required |
sourceLanguage |
입력 문서의 언어를 지정합니다. sourceLanguage 매개 변수를 지정하지 않으면 자동 언어 검색이 적용되어 원본 언어를 결정합니다. |
선택 사항 |
-H 또는 --header "Ocp-Apim-Subscription-Key:{KEY} |
API에 대한 액세스 권한을 부여하는 문서 번역 리소스 키를 지정하는 요청 헤더입니다. | Required |
-F 또는 --form |
요청에 포함할 문서에 대한 파일 경로입니다. 원본 문서는 하나만 허용됩니다. | Required |
• document= • type={contentType}/fileExtension |
• 원본 문서의 파일 위치에 대한 경로입니다. • 콘텐츠 형식 및 파일 확장명입니다. 예: "document=@C:\Test\test-file.md; type=text/markdown" |
Required |
-o 또는 --output |
응답 결과에 대한 파일 경로입니다. | Required |
-F 또는 --form |
요청에 포함할 선택적 용어집에 대한 파일 경로입니다. 용어집에는 별도의 --form 플래그가 필요합니다. |
선택 사항 |
• glossary= • type={contentType}/fileExtension |
• 선택적 용어집 파일의 파일 위치 경로입니다. • 콘텐츠 형식 및 파일 확장명입니다. 예: "glossary=@C:\Test\glossary-file.txt; type=text/plain |
선택 사항 |
✔️ 자세한 contentType
내용은 지원되는 문서 형식을 참조하세요.
코드 샘플: 문서 번역
참고 항목
- 각 샘플은
localhost
명령을 사용하여 지정한 샘플에서docker compose up
실행됩니다. - 컨테이너가 실행되는
localhost
동안 컨테이너 자체를 가리킵니다. - 를 사용할
localhost:5000
필요가 없습니다. 호스트 환경에서 아직 사용되지 않는 모든 포트를 사용할 수 있습니다.
샘플 문서
이 프로젝트의 경우 번역할 원본 문서가 필요합니다. 문서 번역 샘플 문서를 다운로드하여 파일(container-environment
)과 동일한 폴더에 저장할 수 있습니다compose.yaml
. 파일 이름이 document-translation-sample.docx
고 원본 언어는 영어입니다.
Azure AI 번역기 엔드포인트 쿼리(문서)
다음은 localhost:5000을 사용하는 cURL HTTP 요청의 예입니다.
curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2023-11-01-preview" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"
성공적으로 완료된 경우
- 번역된 문서는 응답과 함께 반환됩니다.
- 성공적인 POST 메서드는 서비스에서 요청을 생성했음을 나타내는 응답 코드를 반환
200 OK
합니다.