문서 번역
- 인쇄
- PDF
문서 번역
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
문서 파일을 번역하여 출력합니다. 정상 호출 시 Request ID를 발급하며, 발급된 ID는 문서 번역 진행 상태 확인과 문서 번역 결과 다운로드에 사용됩니다.
참고
사용 전 다음 내용을 참고해 주십시오.
- 이미지로 된 텍스트는 번역 불가
- 텍스트에 적용된 스타일은 일부 일치하지 않거나 누락될 수 있음
- 텍스트에 적용된 링크나 액션은 일부 동작하지 않거나 누락될 수 있음
- 암호가 설정된 파일 미지원
- 읽기 전용 파일 미지원
- 번역 진행 단계에 있는 문서를 포함하여, 최대 5개의 API 동시 호출 가능
지원하는 문서별 참고 사항
Doc Translation은 Microsoft Office 문서, PDF 문서, 한글 문서의 번역을 지원합니다. API 사용 시 지원하는 문서별 참고 사항을 확인해 주십시오.
| 문서 종류 | 참고 사항 |
|---|---|
| Microsoft Office 문서 |
|
| PDF 문서 |
|
| 한글 문서 |
|
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| POST | /translate |
요청 헤더
Papago Translation API에서 공통으로 사용하는 헤더에 대한 정보는 Papago Translation 공통 헤더를 참조해 주십시오.
요청 바디
요청 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
source | String | Required | 원본 텍스트(Source)의 언어 코드
|
target | String | Required | 번역할 텍스트(Target)의 언어 코드
|
file | File | Required | 번역할 문서 파일
|
번역 지원 언어
번역 지원 언어에 대한 설명은 다음과 같습니다.
| 원어 | 번역 방향 | 번역 지원(호환) 언어 |
|---|---|---|
| 한국어 | ⇔ | 영어, 일본어, 중국어(간체) |
| 영어 | ⇔ | 한국어, 일본어 |
| 중국어(간체) | ⇔ | 한국어 |
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request POST 'https://naveropenapi.apigw.ntruss.com/doc-trans/v1/translate' \
--header 'X-NCP-APIGW-API-KEY-ID: {앱 등록 시 발급받은 Client ID}' \
--header 'X-NCP-APIGW-API-KEY: {앱 등록 시 발급 받은 Client Secret}' \
--header 'Content-Type: multipart/form-data' \
--form 'source="auto"' \
--form 'target="ko"' \
--form 'file=@"{file}"'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
data | Object | - | 응답 결과 |
data.requestId | String | - | 번역 요청으로 발급된 아이디(Request ID)
|
응답 상태 코드
Papago Translation API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Papago Translation 공통 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
{
"data": {
"requestId": "20240823_1724375809035_033"
}
}
이 문서가 도움이 되었습니까?