Papago Translation 개요

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

Papago Translation은 인공신경망 기반의 기계 번역(Neural Machine Translation) 알고리즘을 통해 여러 나라의 언어(소스)를 타깃 언어로 자동 번역해주는 네이버 클라우드 플랫폼의 서비스입니다. 텍스트 번역, 문서 번역, 웹 번역, 언어 감지, 용어집 기능에 대한 API를 RESTful 형태로 제공합니다.

참고

Papago Translation API는 사용자의 원문 데이터를 저장하거나 학습 데이터로 활용하지 않습니다.

Papago Translation 공통 설정

Papago Translation API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

Text Translation: https://papago.apigw.gov-ntruss.com/nmt/v1
Doc Translation: https://papago.apigw.gov-ntruss.com/doc-trans/v1
Website Translation: https://papago.apigw.gov-ntruss.com/web-trans/v1
Language Detection: https://papago.apigw.gov-ntruss.com/langs/v1
Glossary: https://papago.apigw.gov-ntruss.com/glossary

요청 헤더

헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-api-key-id Required 네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client ID
x-ncp-apigw-api-key Required 네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client Secret
Content-Type Conditional 클라이언트가 처리 가능한 데이터 타입
  • application/json | multipart/form-data | application/x-www-form-urlencoded
    • Text Translation: application/json, application/x-www-form-urlencoded
    • Doc Translation: multipart/form-data
    • Website Translation: application/x-www-form-urlencoded
참고

네이버 클라우드 플랫폼 콘솔에서 Application을 등록하여 API 사용에 필요한 인증 정보(Client ID, Client Secret)를 발급받는 방법은 Papago Translation 사용 가이드의 APIs를 참조해 주십시오.
콘솔에서 Application 등록 후 Papago Translation API를 선택하지 않으면 429(Quota Exceed) 오류가 발생합니다.

응답

공통 응답 형식을 설명합니다.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

Text Translation
Text Translation에서 사용하는 응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
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 sourcetarget이 동일
400 N2MT06 There is no source-to-target translator sourcetarget 번역기 없음
400 N2MT07 text parameter is needed text 파라미터 누락
400 N2MT08 text parameter exceeds max length text 파라미터가 허용되는 최대 용량 초과
400 N2MT09 language detection failed 언어 감지 실패
400 N2MT10 invalid glossary key glossayKey가 유효하지 않음
500 N2MT99 Internal server errors 서버 내부 오류

Doc Translation
Doc Translation에서 사용하는 응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
400 00001 Request is invalid 잘못된 파라미터가 존재
400 00006 API call failed 지원하지 않는 언어쌍 또는 파일 확장자로 요청
401 25003 requestId is invalid -
404 25006 Not Found -
413 25004 Request Entity Too Large 허용되는 파일 용량 초과(최대 100 MB)
429 25005 Too many requests 동시 번역 요청 수 초과
500 00000 API call failed 서버 내부 오류
500 25001 API call failed 서버 내부 오류
- 01 Error upload file to server 파일 업로드 실패
- 10 Translated Doc is empty 문서 파일 내 글자가 비어 있음
- 11 Translated Docs length exceeded max-len 문서 파일 내 번역 가능 글자 수 초과
- 15 Parsing is not possible 파싱 라이브러리 실패(번역 불가 파일)
- 16 Unsupported source language 지원하지 않는 소스 언어
- 17 Detected langcode is the same as target langcode 소스 언어와 타깃 언어가 동일
- 18 Language detection failed 언어 감지 실패
- 36 PDF Resolution Error 지원 해상도 초과
- 37 the target language is the same as the source language 번역언어와 문서 언어가 동일
- 38 invalid glossary key glossayKey가 유효하지 않음
- 50 internal parser error 내부 파서 오류
- 60 internal server error 서버 내부 오류

Website Translation
Website Translation에서 사용하는 응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
400 00001 Request is invalid source, target, html 파라미터 누락
500 20001 Source and target are equal sourcetarget 언어가 동일
400 20006 Exceed max requests size allowed html 파라미터가 허용되는 최대 용량 초과
400 N2MT02 Unsupported source language source를 지원하지 않음
400 N2MT04 Unsupported target language target을 지원하지 않음
400 N2MT05 invalid glossary key 유효하지 않은 용어집 키
500 00000 API call failed 서버 내부 오류

Language Detection
Language Detection에서 사용하는 응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
400 LD01 Empty text 언어를 감지할 text가 없음
400 LD01 Empty query parameter 언어를 감지할 text가 없음
400 LD03 Query parameter exceeds max length 언어를 감지할 text의 허용되는 길이제한을 초과함 (최대 5,000 자)
500 LD99 Internal server errors 서버 내부 오류

Glossary
Glossary에서 사용하는 응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
204 - - 용어집 삭제 완료
400 - - Bad Request
400 30009 Invalid Character 입력할 수 없는 특수 문자 , 포함

Papago Translation API

Papago Translation 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

API 설명
Text Translation > translation 텍스트 번역
Doc Translation > translation 문서 번역
Doc Translation > status 문서 번역 상태 확인
Doc Translation > download 문서 번역 결과 다운로드
Website Translation > website translation 웹 번역
Language Detection > detect 언어 감지
Glossary > create 용어집 생성
Glossary > upload 용어집 파일 업로드
Glossary > download 용어집 파일 다운로드
Glossary > get 용어집 목록 조회
Glossary > delete 용어집 삭제

Papago Translation 연관 리소스

Papago Translation API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.