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-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-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지원하지 않는 언어쌍 또는 파일 확장자로 요청
    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언어 감지 실패
    -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

    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.