Papago Website Translation 개요
    • PDF

    Papago Website Translation 개요

    • PDF

    기사 요약

    개요

    • 소스 언어로 작성된 html문서 혹은 element를 타겟 언어로 번역하는 API
    • 번역 지원 언어쌍: 한국어↔영어, 한국어↔일본어, 한국어↔중국어(간체)

    사용 시 유의사항

    • 이미지로 된 텍스트는 번역되지 않습니다.
    • 텍스트에 적용된 스타일은 일부 일치하지 않거나 누락될 수 있습니다.
    • 텍스트에 적용된 링크 또는 액션은 일부 동작하지 않거나 누락될 수 있습니다.
    • html 파라미터는 크기 제한이 있습니다. (UTF-8 기준 태그, 공백 등 모든 캐릭터 포함 200,000bytes)
    • html 파라미터의 크기가 클수록 responseTime이 느려지기 때문에 번역할 영역의 element 요청을 권장합니다. (하단 번역 영역 추출 예제 참고)
    • 1회당 권장 최대 글자: 60,000자
    • 1분당 권장 최대 글자: 3,600,000자
    • 과금: 태그 및 공백 포함 모든 캐릭터 수 카운팅

    공통 설정

    클라이언트 아이디는 NAVER Cloud Platform 콘솔에서 애플리케이션을 등록해 발급받습니다.

    1. 콘솔의 AI Service > Papago Translation > APIs에서 애플리케이션을 등록합니다.

    2. AI Service > Papago Translation > APIs에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.

    3. AI Service > Papago Translation > APIs수정 화면에서 Papago Website Translation이 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의해 주십시오.

    오류 코드

    {
      "error": {
        "errorCode": "300",
        "message": "Not Found Exception"
      }
    }
    
    HttpStatusCodeErrorCodeErrorMessageDescription
    400100Bad Request Exceptionprotocol(https), endocing(UTF-8) 등 request 오류
    401200Authentication Failed인증실패
    401210Permission Denied권한없음
    404300Not Found Exception권한없음
    429400Quota ExceededQuota 초과
    429410Throttle LimitedRate 초과
    429420Rate LimitedRate 초과
    413430Request Entity Too Largecontent-length 초과 (10MB)
    503500Endpoint Error엔드포인트 연결오류
    504510Endpoint Timeout엔드포인트 연결시간 초과
    500900Unexpected Error예외처리가 안된 오류

    API 오류

    {
        "code": "20001",
        "message": "Source and target are equal.",
        "displayMessage": "Source and target are equal."
    }
    
    HttpStatusCodeErrorCodeErrorMessageDescription
    50000000API called failed내부 서버 에러
    40000001Request is invalidsource, target, html 파라미터 없는 경우
    50020001Source and target are equalsource와 target이 같을 경우
    40020006Exceed max requests size allowedhtml 파라미터 최대 용량 초과
    400N2MT02Unsupported source language지원하지 않는 source 언어
    400N2MT04Unsupported target language지원하지 않는 target 언어

    번역 영역 추출 예제

    className으로 번역할 영역을 추출하는 샘플코드로 이 외 영역을 추출하는 다양한 방법 중 가장 적합한 방법을 사용하시는 것을 권장합니다.

    <!DOCTYPE html>
    <html lang="ko">
      <head>
        <meta charset="UTF-8" />
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>Example</title>
    </head>
      <body>
        <!-- comments -->
        <ul class="comment_container">
          <!-- comment -->
          <li class="comment_item_wrapper">
            <div class="user_info">
              <span class="nickname">user1</span>
            </div>
            <div class="content">
              <p>
                Lorem ipsum dolor sit amet consectetur adipisicing elit. Natus
                nostrum in earum minus voluptates nobis fugiat rerum totam illum
                ipsum.
              </p>
            </div>
          </li>
          <!-- comment -->
    
          <!-- comment -->
          <li class="comment_item_wrapper">
            <div class="user_info">
              <span class="nickname">user2</span>
            </div>
            <div class="content">
              <p>Lorem ipsum dolor sit amet.</p>
            </div>
          </li>
          <!-- comment -->
    
          <!-- comment -->
          <li class="comment_item_wrapper">
            <div class="user_info">
              <span class="nickname">user3</span>
            </div>
            <div class="content">
              <p>
                Lorem ipsum dolor sit, amet consectetur adipisicing elit. Ex tempora
                ipsa iusto temporibus consectetur. Libero sequi consequatur
                quibusdam dignissimos totam, praesentium harum dolor nisi
                repudiandae in error tempora incidunt aperiam.
              </p>
            </div>
          </li>
          <!-- comment -->
    
          <!-- comment -->
          <li class="comment_item_wrapper">
            <div class="user_info">
              <span class="nickname">user4</span>
            </div>
            <div class="content">
              <p>
                Lorem ipsum dolor sit amet consectetur adipisicing elit. Natus
                nostrum in earum minus voluptates nobis fugiat rerum totam illum
                ipsum.
              </p>
              <br />
              <p>Lorem ipsum dolor sit amet.</p>
            </div>
          </li>
          <!-- comment -->
        </ul>
        <!-- comments -->
    
        <script>
          const comments = [
            ...document.getElementsByClassName('comment_item_wrapper'),
          ];
          const htmlsToRequest = comments.map((comment) => comment.outerHTML);
    
          console.log(htmlsToRequest);
        </script>
      </body>
    </html>
    

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

    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.