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 콘솔에서 애플리케이션을 등록해 발급받습니다.

콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >
AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
AI·NAVER API > AI·NAVER API > Application의 변경 화면에서 Papago Website Translation이 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

오류 코드

{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}

HttpStatusCode	ErrorCode	ErrorMessage	Description
400	100	Bad Request Exception	protocol(https), endocing(UTF-8) 등 request 오류
401	200	Authentication Failed	인증실패
401	210	Permission Denied	권한없음
404	300	Not Found Exception	권한없음
429	400	Quota Exceeded	Quota 초과
429	410	Throttle Limited	Rate 초과
429	420	Rate Limited	Rate 초과
413	430	Request Entity Too Large	content-length 초과 (10MB)
503	500	Endpoint Error	엔드포인트 연결오류
504	510	Endpoint Timeout	엔드포인트 연결시간 초과
500	900	Unexpected Error	예외처리가 안된 오류

API 오류

{
    "code": "20001",
    "message": "Source and target are equal.",
    "displayMessage": "Source and target are equal."
}

HttpStatusCode	ErrorCode	ErrorMessage	Description
500	00000	API called failed	내부 서버 에러
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 언어

번역 영역 추출 예제

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>

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

What's Next

dect (언어감지)

개요
사용 시 유의 사항
공통 설정

태그