translate (문서 번역 요청)

Prev Next

개요

  • 문서 파일 번역 요청 API (POST)
  • 정상 업로드 시, Request ID를 발급 → Status/Download API 호출 시 사용
  • 번역 진행 단계에 있는 문서를 포함하여 최대 5개의 API 동시 호출 가능

Header

Name Description
Content-Type multipart/form-data 형식으로 전송 필요
X-NCP-APIGW-API-KEY-ID NCP 앱 등록 시 발급받은 Client ID
X-NCP-APIGW-API-KEY NCP 앱 등록 시 발급받은 Secret Key

Parameter

Name Type Required Description
source String{ko,ja,en,zh-CN} true 소스 언어 코드
* auto 설정 시, 자동으로 소스 언어 감지
target String{ko,ja,en,zh-CN} true 타겟 언어 코드
file File true 번역할 파일
glossaryKey String false - 클라우드 콘솔에서 용어집 기능을 사용하는 경우, 해당 용어집의 Glossary Key에 대응 (ex. 6ae8eba5-3154-4646-bc16-1c96532082e6)
- 용어집 데이터를 기반으로 치환 번역 적용
- 한⇔영/한⇔일/한⇔중(간체)/영⇔일 가능

Response

json 형식으로 리턴

Field Name Type Description
data JSON Object
data requestid String 요청한 파일 번역에 대한 Request id 발급

요청 성공 시 Example

{
  "data": {
    "requestId": "20201007_2522985202669_001"
  }
}

오류 코드

{
  "error": {
    "errorCode": "25001",
    "message": "API call failed"
  }
}
HttpStatusCode code message Description
400 00006 API call failed 지원하지 않는 언어쌍, 파일 확장자로의 요청
500 25001 API call failed 내부 서버 에러
413 25004 Request Entity Too Large 제한된 파일 용량 초과 (100MB)
429 25005 Too many requests 동시 번역 요청 수 초과

CURL Example

$ curl -X POST -F file=@a.xlsx -F source=ko -F target=en 'https://papago.apigw.gov-ntruss.com/doc-trans/v1/translate'
{"data":{"requestId":"20201007_2522985202669"}}