MENU
      Papago Translation 개요
        • 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-trans/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
        HTTP

        요청 헤더

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

        필드필수 여부설명
        x-ncp-apigw-api-key-idRequired네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client ID
        x-ncp-apigw-api-keyRequired네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client Secret
        Content-TypeConditional클라이언트가 처리 가능한 데이터 타입
        • 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 상태 코드코드메시지설명
        400N2MT01source parameter is neededsource 파라미터 누락
        400N2MT02Unsupported source languagesource를 지원하지 않음
        400N2MT03target parameter is neededtarget 파라미터 누락
        400N2MT04Unsupported target languagetarget을 지원하지 않음
        400N2MT05source and target must be differentsourcetarget이 동일
        400N2MT06There is no source-to-target translatorsourcetarget 번역기 없음
        400N2MT07text parameter is neededtext 파라미터 누락
        400N2MT08text parameter exceeds max lengthtext 파라미터가 허용되는 최대 용량 초과
        400N2MT09language detection failed언어 감지 실패
        400N2MT10invalid glossary keyglossayKey가 유효하지 않음
        500N2MT99Internal server errors서버 내부 오류

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

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

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

        HTTP 상태 코드코드메시지설명
        40000001Request is invalidsource, target, html 파라미터 누락
        50020001Source and target are equalsourcetarget 언어가 동일
        40020006Exceed max requests size allowedhtml 파라미터가 허용되는 최대 용량 초과
        400N2MT02Unsupported source languagesource를 지원하지 않음
        400N2MT04Unsupported target languagetarget을 지원하지 않음
        50000000API call failed서버 내부 오류

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

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

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

        HTTP 상태 코드코드메시지설명
        204--용어집 삭제 완료
        400--Bad Request
        40030009Invalid 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에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.


        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.