문서 번역 작업
참조
기능: Azure AI Translator → 문서 번역
문서 번역은 Azure 번역기 서비스의 클라우드 기반 기능이며 REST API의 Azure Cognitive Service 제품군의 일부입니다. Batch 문서 번역 API는 문서 구조와 데이터 형식을 유지하면서 지원되는 모든 언어 및 언어 로 문서를 번역합니다. 사용 가능한 메서드는 다음 표에 나와 있습니다.
API 버전: 2024-05-01
참고 항목
현재 버전은 레거시 버전과 이전 버전과 호환됩니다.
이 현재 버전부터 메서드는
get supported storage sources더 이상 지원되지 않습니다. Translator 서비스는 Azure Blob Storage만 지원합니다.
| 요청 | 메서드 | 설명 | API 경로 |
|---|---|---|---|
| Single | 동기 | Document | 번역 |
| 문서 번역 | POST | 단일 문서를 동기적으로 번역합니다. | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| Batch | 비동기 | 문서 | 번역 |
| 번역 시작 | POST | 일괄 처리 문서 번역 작업을 시작합니다. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| 모든 번역 작업의 상태 가져오기 | GET | 사용자가 제출한 번역 작업의 목록 및 상태를 요청합니다. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| 특정 번역 작업의 상태 가져오기 | GET | 특정 번역 작업의 상태에 대한 요약을 요청합니다. 응답에는 전체 작업 상태 및 해당 작업의 일부로 번역되는 문서의 상태가 포함됩니다. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| 모든 문서에 대한 상태 가져오기 | GET | 번역 작업에서 모든 문서의 상태를 요청합니다. | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| 특정 문서의 상태 가져오기 | GET | 작업의 특정 문서에 대한 상태를 요청합니다. | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| 번역 취소 | DELETE | 현재 처리 중이거나 큐에 대기 중인 문서 번역 작업을 취소합니다. | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| 지원되는 문서 형식 가져오기 | GET | 지원되는 문서 형식 목록을 요청합니다. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| 지원되는 용어집 형식 가져오기 | GET | 지원되는 용어집 형식 목록을 요청합니다. | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
레거시
참고 항목
- 레거시 버전은 현재 버전과 이전 버전과 호환됩니다. 두 버전의 작업을 사용하여 문서를 번역할 수 있습니다.
- 향상된 환경과 고급 기능을 활용하려면 애플리케이션을 최신 버전으로 마이그레이션하는 것이 좋습니다.
| 요청 | 메서드 | 설명 | API 경로 |
|---|---|---|---|
| Single | 동기 | Document | 번역 |
| 문서 번역 | POST | 단일 문서를 동기적으로 번역합니다. | {document-translation-endpoint}/translator/document:translate?sourceLanguage={source language}&targetLanguage={target language}&api-version=2024-05-01" -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}" |
| Batch | 비동기 | 문서 | 번역 |
| 번역 시작 | POST | 일괄 처리 문서 번역 작업을 시작합니다. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| 모든 번역 작업의 상태 가져오기 | GET | 사용자가 제출한 번역 작업의 목록 및 상태를 요청합니다. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| 특정 번역 작업의 상태 가져오기 | GET | 특정 번역 작업의 상태에 대한 요약을 요청합니다. 응답에는 전체 작업 상태 및 해당 작업의 일부로 번역되는 문서의 상태가 포함됩니다. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| 모든 문서에 대한 상태 가져오기 | GET | 작업의 특정 문서에 대한 상태를 요청합니다. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
| 특정 문서의 상태 가져오기 | GET | 작업의 특정 문서에 대한 상태를 요청합니다. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| 번역 취소 | DELETE | 현재 처리 중이거나 큐에 대기 중인 문서 번역 작업을 취소합니다. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| 지원되는 문서 형식 가져오기 | GET | 지원되는 문서 형식 목록을 요청합니다. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
| 지원되는 용어집 형식 가져오기 | GET | 지원되는 용어집 형식 목록을 요청합니다. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
| 지원되는 스토리지 원본 가져오기 | GET | 지원되는 스토리지 원본/옵션 목록을 요청합니다. 현재 Translator 서비스는 Azure Blob Storage만 지원합니다. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |