Papago Website Translation の概要

印刷する
共有
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

概要

ソース言語で作成された HTML文書、または elementをターゲット言語に翻訳する API
翻訳サポート言語ペア: 韓国語↔英語、韓国語↔日本語、韓国語↔中国語(簡体字)

使用時の留意事項

画像のテキストは翻訳されません。
テキストに適用されたスタイルは、一部一致しなかったり漏れることがあります。
テキストに適用されたリンクまたはアクションは、一部動作していないか、欠落している可能性があります。
htmlパラメータにはサイズ制限があります。(UTF-8の基準タグ、スペースなどすべての文字を含めて200000byte)
htmlパラメータのサイズが大きいほど responseTimeが遅くなるため、翻訳する領域の elementリクエストをお勧めします。(下部の翻訳領域抽出例を参照)
1回当たりの推奨最大文字数: 60,000字
1分当たりの推奨最大文字数: 3,600,000字
課金: タグおよびスペースを含めるすべての文字数をカウント

共通設定

クライアント IDは、NAVER Cloud Platformコンソールでアプリケーションを登録すると発行されます。

コンソールの AI Service > Papago Translation > APIsでアプリケーションを登録します。
AI Service > Papago Translation > APIsで登録したアプリケーションを選択し、Client IDと Client Secretの値を確認します。
AI Service > Papago Translation > APIsの修正画面で、Papago Website Translationが選択されているか確認します。選択されていないと429(Quota Exceed)が発生するため、ご注意ください。

エラーコード

共通エラー

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

HttpStatusCode	ErrorCode	ErrorMessage	Description
400	100	Bad Request Exception	protocol(https)、encoding(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

translation(ウェブサイトの翻訳リクエスト)

概要
使用時の留意事項
共通設定

タグ

Papago Translation