Papago Text Translation 개요

Prev Next

네이버가 자체적으로 개발한 인공신경망 기반의 기계 번역 기술인 NMT(Neural Machine Translation)를 이용한 번역 서비스로, 맥락이 고려된 자연스러운 번역 결과를 얻을 수 있습니다.

공통 설정

클라이언트 아이디는 NAVER Cloud Platform 콘솔에서 애플리케이션을 등록해 발급받습니다.

  1. 콘솔의 AI Service > Papago Translation > APIs에서 애플리케이션을 등록합니다.

  2. AI Service > Papago Translation > APIs에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.

  3. AI Service > Papago Translation > APIs의 API 관리 의 수정화면에서 Papago Text Translation이 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

API URL

API 명 메서드 요청 URL 출력 포맷
N2MT POST https://papago.apigw.gov-ntruss.com JSON

요청 헤더

헤더명 설명
X-NCP-APIGW-API-KEY-ID 앱 등록 시 발급받은 Client ID
X-NCP-APIGW-API-KEY-ID:{Client ID}
X-NCP-APIGW-API-KEY 앱 등록 시 발급 받은 Client Secret
X-NCP-APIGW-API-KEY:{Client Secret}

오류 코드

{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}

공통 오류

HttpStatusCode ErrorCode ErrorMessage Description
400 100 Bad Request Exception protocol(https), endocing(UTF-8) 등 request 오류
401 200 Authentication Failed 인증실패
401 210 Permission Denied 권한없음
404 300 Not Found Exception 권한없음
429 400 Quota Exceeded Quota 초과
429 410 Throttle Limited Rate 초과
429 420 Rate Limited Rate 초과
413 430 Request Entity Too Large content-length 초과 (10MB)
503 500 Endpoint Error 엔드포인트 연결오류
504 510 Endpoint Timeout 엔드포인트 연결시간 초과
500 900 Unexpected Error 예외처리가 안된 오류

API 오류

HttpStatusCode ErrorCode ErrorMessage Description
400 N2MT01 source parameter is needed source 파라미터 필요
400 N2MT02 Unsupported source language 지원하지 않는 source 언어
400 N2MT03 target parameter is needed target 파라미터 필요
400 N2MT04 Unsupported target language 지원하지 않는 target 언어
400 N2MT05 source and target must be different source와 target이 동일
400 N2MT06 There is no source-to-target translator source->target 번역기가 없음
400 N2MT07 text parameter is needed text 파라미터 필요
400 N2MT08 text parameter exceeds max length text 파라미터가 최대 용량 초과
500 N2MT99 Internal server errors 내부 서버 오류