Papago NMT
개요
네이버가 자체적으로 개발한 인공신경망 기반의 기계 번역 기술인 NMT(Neural Machine Translation)를 이용한 번역 서비스입니다. 입력된 문장을 쪼개어 번역하는 것이 아니라 문구를 통째로 번역하기 때문에, 맥락이 고려된 자연스러운 번역 결과를 얻을 수 있습니다.
공통 설정
클라이언트 아이디는 네이버 클라우드 플랫폼 콘솔에서 애플리케이션을 등록해 발급받습니다.
콘솔의 AI·Application Service > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >
AI·Application Service > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
AI·Application Service > AI·NAVER API > Application의 변경 화면에서 Papago NMT가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.
API URL
API 명 | 메서드 | 요청 URL | 출력 포맷 |
---|---|---|---|
N2MT | POST | https://naveropenapi.apigw.gov-ntruss.com/nmt/v1/translation |
JSON |
요청 헤더
헤더 명 | 설명 |
---|---|
X-NCP-APIGW-API-KEY-ID | 앱 등록 시 발급받은 Client IDX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | 앱 등록 시 발급 받은 Client SecretX-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 | conent-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 | 내부 서버 에러입니다. |