컨테이너: 문서 번역
원본 언어가 지정된 문서를 번역합니다.
요청 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=2024-05-01" -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 Translator 엔드포인트 쿼리(문서)
다음은 localhost:5000을 사용하는 cURL HTTP 요청의 예입니다.
curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2024-05-01" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"
성공적으로 완료된 경우
- 번역된 문서가 응답과 함께 반환됩니다.
- 성공적인 POST 메서드는 서비스가 요청을 만들었음을 나타내는
200 OK응답 코드를 반환합니다.