- 인쇄
- PDF
Papago Translation 개요
- 인쇄
- PDF
Classic/VPC 환경에서 이용 가능합니다.
Papago Translation은 인공신경망 기반의 기계 번역(Neural Machine Translation) 알고리즘을 통해 여러 나라의 언어(소스)를 타깃 언어로 자동 번역해주는 네이버 클라우드 플랫폼의 서비스입니다. 텍스트 번역, 문서 번역, 웹 번역, 언어 감지, 기능에 대한 API를 RESTful 형태로 제공하며, API를 호출하려면 API Gateway의 IAM 인증을 완료해야 합니다.
Papago Translation API는 사용자의 원문 데이터를 저장하거나 학습 데이터로 활용하지 않습니다.
Papago Translation 공통 설정
Papago Translation API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.
요청
공통 요청 형식을 설명합니다.
API URL
요청 API URL은 다음과 같습니다.
Text Translation: https://naveropenapi.apigw.ntruss.com/nmt/v1
Doc Translation: https://naveropenapi.apigw.ntruss.com/doc-transs/v1
Website Translation: https://naveropenapi.apigw.ntruss.com/web-trans/v1
Language Detection: https://naveropenapi.apigw.ntruss.com/langs/v1
Glossary: https://papago.apigw.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을 등록하여 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 | 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 파라미터가 허용되는 최대 용량 초과 |
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 | 언어 감지 실패 |
- | 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 | source 와 target 언어가 동일 |
400 | 20006 | Exceed max requests size allowed | html 파라미터가 허용되는 최대 용량 초과 |
400 | N2MT02 | Unsupported source language | source 를 지원하지 않음 |
400 | N2MT04 | Unsupported target language | target 을 지원하지 않음 |
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 |
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에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.
- Papago Translation API 사용 방법
- 서명(시그니처) 생성: 요청 헤더에 추가할 서명 생성 방법
- Ncloud 공통 응답 상태 코드: Papago Translation 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Cloud Insight 사용 가이드: Application 사용 한도 알림 설정에 필요한 Cloud Insight 이용 신청 방법 및 알림 통보 대상자 추가 방법 안내
- Sub Account 사용 가이드: Papago Translation의 운영 권한 관리를 도와주는 Sub Account 사용 방법 안내
- Papago Translation 서비스 사용 방법
- Papago Translation 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 Application 등록, 용어집 관리, 사용량 확인 및 통보 설정 방법
- Papago Translation 사용 준비: Papago Translation에서 지원되는 환경 사양, 사용 시 유의 사항, 이용 요금 안내
- Ncloud 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 관한 사용 가이드
- 요금 소개, 특징, 상세 기능: Papago Translation의 요금 체계, Papago Translation의 특징 및 상세 기능 요약
- 서비스 최신 소식: Papago Translation 관련 최신 소식
- 자주 하는 질문: Papago Translation 사용자들이 자주 하는 질문
- 문의하기: 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의