Contents
Papago Text Translation API の概要
Papago Text Translation API は Naver Cloud が提供する機械翻訳サービスです。REST API からテキストを多言語へ変換でき、Web アプリ・モバイルアプリ・チャットボットなどさまざまなシーンで活用できます。本稿では、対応言語・料金体系・利用手順・実装例といった「導入に必要な情報」を網羅的に解説し、開発者がすぐに試せる形にまとめます。
対応言語数と対象言語一覧
このセクションでは Papago が公式にサポートしている 13 カ国語（計 13 種類の言語コード）を紹介します。日本語・英語だけでなく、アジア圏や欧州圏でも利用できる点が特徴です。
言語コードと名称（アルファベット順）
| コード | 日本語表記 |
|---|---|
ko |
韓国語 |
en |
英語 |
ja |
日本語 |
zh-CN |
中国語（簡体字） |
zh-TW |
中国語（繁体字） |
es |
スペイン語 |
fr |
フランス語 |
vi |
ベトナム語 |
id |
インドネシア語 |
th |
タイ語 |
ru |
ロシア語 |
de |
ドイツ語 |
it |
イタリア語 |
ポイント：上記 13 言語はすべて相互に翻訳可能です（例:
ko → en,en → koだけでなく、ja → deなども可）。公式ドキュメントの「Supported Languages」ページ[^1]をご参照ください。
2026 年版 Papago Translation API の料金体系
本節では Naver Cloud 公式料金表（2026‑05 更新）を元に、無料枠・従量課金・エンタープライズプランの概要を示します。外部サイトへのリンクは排除し、信頼できる一次情報のみを使用しています。
無料枠と標準従量課金（Standard プラン）
| 項目 | 内容 |
|---|---|
| 無料枠 | 月間 150,000 文字まで無料（API キー単位） |
| 従量課金単価 | 0.0005 USD / 文字（約 0.075 円／文字、為替レート 1 USD = 150 JPY 前提） |
| 請求サイクル | 月次請求。コンソールの「使用状況」からリアルタイムに文字数を確認可能 |
計算例：月間 300,000 文字利用の場合、無料枠超過分は 150,000 文字 × 0.075 円 ≈ 11,250 円 のみ課金されます。
エンタープライズプラン（Enterprise）
| プラン | 月額料金 (USD) | 年間契約割引 | 主な特典 |
|---|---|---|---|
| Standard（従量課金） | 0.0005 USD/文字 | – | 無制限文字数、基本レート適用 |
| Enterprise | $2,000 / 月 | 年間契約で 20% 割引 → $1,600 / 月 | SLA 99.9%、専用サポート、VPC 接続、カスタム語彙管理、文字数上限なし |
エンタープライズプランは大規模トラフィックやミッションクリティカルなシステム向けです。導入前に 見積もり依頼（公式コンソールの「お問い合わせ」）を行うと、利用パターンに合わせた最適プランが提示されます。
レートリミット
公式ドキュメント[^2]によると、Standard プランのレートリミットは 1 分あたり最大 10,000 文字（リクエスト回数ではなく文字数ベース）です。Enterprise プランではこの上限が緩和され、個別にカスタマイズ可能となります。超過した場合は HTTP 429 が返り、指数的バックオフで再試行する実装が推奨されています。
Papago API を利用開始するには、Naver Cloud のアカウントを取得し、サービス有効化とキー発行を行う必要があります。以下は公式コンソールに沿った ステップバイステップ ガイドです。
アカウント登録
- Naver Cloud 公式サイト（https://www.ncloud.com/）へアクセスし「無料アカウント作成」ボタンをクリック。
- メールアドレス・パスワード・氏名・電話番号を入力し、認証コードで本人確認を完了させる。
- 送付されたメールの認証リンクをクリックしてアカウントを有効化する。
Papago Translation サービスの有効化
- コンソール左メニュー → AI / データ分析 → Papago Translation を選択。
- 「利用開始」ボタンを押し、利用規約に同意するとサービスが有効になる。
- ダッシュボード上部の「API キー管理」へ遷移し、次節で説明するキー発行画面に進む。
Access Key / Secret Key の取得と安全な保管
- 「アクセスキー発行」をクリックし、表示された
Access Key IDとSecret Access Keyをコピー。 - 環境変数（例：
NAVER_CLIENT_ID,NAVER_CLIENT_SECRET）やクラウドシークレットマネージャーに保存し、コード内へハードコーディングしないことがベストプラクティスです。 - 定期的なローテーションを実施する。漏洩が疑われる場合はコンソールから 削除 → 再発行 の手順で即座にキーを更新できる。
必須表記：Papago API を使用した画面・ドキュメントには、必ず「Powered by Papago (https://papago.naver.com/)」のブランド表示と公式リンクを掲載してください（Ncloud ガイドライン参照）[^3]。
API リクエスト仕様と実装サンプルコード
この章ではリクエスト構造、必須ヘッダー、代表的なプログラミング言語での呼び出し例を示します。まずは 通信要件 を整理し、その後に具体的なコードスニペットをご確認ください。
エンドポイント・HTTP メソッド・必須ヘッダー
| 項目 | 内容 |
|---|---|
| エンドポイント | https://naveropenapi.apigw.ntruss.com/nmt/v1/translation |
| HTTP メソッド | POST |
| Content-Type | application/json |
| 必須ヘッダー | X-NCP-APIGW-API-KEY-ID: <Access Key ID>X-NCP-APIGW-API-KEY: <Secret Access Key> |
リクエストボディ（JSON）
|
1 2 3 4 5 6 |
{ "source": "en", "target": "ja", "text": "Hello, world!" } |
ポイント：
sourceとtargetは言語コード（上記表参照）で指定します。自動判別はサポートされていないため、必ず明示してください。
実装例
cURL
|
1 2 3 4 5 6 7 8 9 10 |
curl -X POST "https://naveropenapi.apigw.ntruss.com/nmt/v1/translation" \ -H "Content-Type: application/json" \ -H "X-NCP-APIGW-API-KEY-ID: YOUR_ACCESS_KEY_ID" \ -H "X-NCP-APIGW-API-KEY: YOUR_SECRET_ACCESS_KEY" \ -d '{ "source":"en", "target":"ja", "text":"Hello, world!" }' |
Python (requests)
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
import os, json, requests url = "https://naveropenapi.apigw.ntruss.com/nmt/v1/translation" headers = { "Content-Type": "application/json", "X-NCP-APIGW-API-KEY-ID": os.getenv("NAVER_CLIENT_ID"), "X-NCP-APIGW-API-KEY": os.getenv("NAVER_CLIENT_SECRET") } payload = {"source":"en", "target":"ja", "text":"Hello, world!"} resp = requests.post(url, headers=headers, data=json.dumps(payload)) print(resp.json()) |
Node.js (axios)
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
const axios = require('axios'); const url = 'https://naveropenapi.apigw.ntruss.com/nmt/v1/translation'; const headers = { 'Content-Type': 'application/json', 'X-NCP-APIGW-API-KEY-ID': process.env.NAVER_CLIENT_ID, 'X-NCP-APIGW-API-KEY': process.env.NAVER_CLIENT_SECRET }; const data = { source: 'en', target: 'ja', text: 'Hello, world!' }; axios.post(url, data, { headers }) .then(r => console.log(r.data)) .catch(e => console.error(e.response?.data)); |
ベストプラクティス：キーは必ず環境変数で管理し、CI/CD パイプラインにシークレットストアを組み込むことで漏洩リスクを低減できます。
レスポンス形式・エラーハンドリング・レートリミットの確認方法
API の安定運用には成功レスポンスだけでなく、障害時の対処法も把握しておく必要があります。ここでは代表的な構造と推奨されるハンドリング手順をまとめます。
成功時の JSON レスポンス
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
{ "message": { "result": { "srcLangType": "en", "tarLangType": "ja", "translatedText": "こんにちは、世界！" }, "metadata": { "sourceLanguageCode": "en", "targetLanguageCode": "ja" } } } |
result.translatedTextが実際の翻訳結果です。srcLangTypeとtarLangTypeはリクエストで指定したコードと一致します。
主なエラーコードと対策
| HTTP ステータス | エラー内容 | 典型的な原因 | 推奨対策 |
|---|---|---|---|
| 400 | Bad Request | パラメータ不足・JSON 不正 | リクエストボディをバリデーション |
| 401 | Unauthorized | API キー未設定または無効 | 環境変数が正しくロードされているか確認 |
| 403 | Forbidden | プランの文字数上限超過 | 料金プラン変更、もしくは利用量削減 |
| 429 | Too Many Requests | レートリミット（1 分/10,000 文字）超過 | 指数的バックオフで再試行 |
| 500 | Internal Server Error | Naver 側の一時障害 | 数秒待機後リトライ、ステータスページ確認 |
エラーが返された場合は、レスポンスボディに errorMessage が含まれることが多く、ログ出力するとデバッグが容易です。
レートリミットと使用状況のモニタリング
- コンソール左メニュー → Papago Translation → 使用状況 を開く。
- 「月間文字数」グラフで現在の消費量と残量がリアルタイムに表示されます。
- 公式ガイド[^2] に記載された「1 分あたり最大 10,000 文字」の上限は、HTTP 429 が返った時点で確認できます。クライアント側では トークンバケット方式 等でスロットリングを実装すると安全です。
コストシミュレーション例と他社サービス比較
実際の利用シナリオを想定し、費用感と主要競合（Google Cloud Translation、DeepL API）との比較を行います。これにより「Papago が最適か」あるいは「他サービスと併用すべきか」の判断材料が得られます。
利用シナリオ別シミュレーション
| シナリオ | 月間文字数 | 無料枠適用後課金文字数 | 従量課金額 (USD) | 従量課金額 (JPY, 1 USD=150 JPY) |
|---|---|---|---|---|
| A：30 万文字 | 300,000 | 150,000（超過分） | 0.0005 × 150,000 = 75 USD | 11,250 円 |
| B：100 万文字 | 1,000,000 | 850,000（超過分） | 0.0005 × 850,000 = 425 USD | 63,750 円 |
備考：Enterprise プランを選択した場合は固定月額 $1,600（年契約割引適用）となり、文字数に関係なく上記金額より高くなる点に注意してください。
主要競合サービスとの価格・機能比較
| 項目 | Papago (2026) | Google Cloud Translation | DeepL API |
|---|---|---|---|
| 従量課金単価 | 0.0005 USD/文字 (~0.075 円) | 0.020 USD / 1,000文字 (=0.003 USD/文字) | 0.02 EUR / 1,000文字 (≈0.0024 USD/文字) |
| 無料枠 | 月間150k文字 | 初回12か月間、500k文字（条件あり） | プロプランで月間500k文字 |
| 対応言語数 | 13 言語 | 100+ 言語 | 28 言語 |
| レイテンシ (日本リージョン) | 約200‑300 ms | 約150‑250 ms（米国/欧州） | 約180‑260 ms (EU) |
| エンタープライズ SLA | 99.9%（専用サポート） | 99.95%（Premium Support） | 99.9%（Enterprise 契約） |
| カスタム語彙 | 有（Glossary API） | 有 (Glossary) | 有 (Custom Glossary) |
- コスト面：同一文字数で比較すると、Papago は Google や DeepL に比べて 4〜5 倍 安価です。
- 機能面：Google と DeepL は自動言語判別や文脈保持に優れ、多言語展開が必要な場合は併用を検討すべきです。
利用事例とベストプラクティス
実務での活用イメージを具体化し、パフォーマンス・セキュリティ面での推奨設定をご紹介します。
代表的な利用シーン
| シナリオ | 主なメリット |
|---|---|
| Eコマース商品説明の多言語化 | 商品ページをリアルタイム翻訳し、海外ユーザーの購入率向上。無料枠内で数十万文字程度ならほぼ無償運用可能。 |
| チャットボットの多言語対応 | ユーザー入力 → Papago 翻訳 → NLP エンジン（例：Dialogflow） → 応答翻訳 のフローで、顧客満足度が向上。 |
| 社内ドキュメント自動翻訳 | 社内 Wiki やマニュアルを API バッチで定期的に更新。文字数の予測が容易なためコスト管理がシンプル。 |
パフォーマンス最適化のポイント
- バッチ送信：1 リクエストあたり 5,000 文字以下に分割し、レートリミット超過を防止。
- キャッシュ活用：同一テキストは Redis 等で結果をキャッシュし、重複翻訳を回避（コスト削減とレイテンシ低減）。
- 非同期処理：大量文字数はキュー（例：AWS SQS, Naver Cloud Queue）に入れ、バックエンドワーカーで逐次呼び出す。
セキュリティ・コンプライアンス
| 項目 | 推奨設定 |
|---|---|
| キー管理 | 環境変数＋シークレットマネージャー（Naver Cloud Secret） |
| 通信暗号化 | HTTPS のみ使用。TLS 1.2 以上を必須にする。 |
| データ保持 | 翻訳結果は必要最小限の期間だけ保存し、不要になったら速やかに削除。 |
| 監査ログ | API コンソールの「アクセス履歴」機能で使用状況とエラーログを定期的にレビュー。 |
まとめ
- Papago Text Translation API は 13 言語 を相互翻訳でき、特に日本・韓国市場向けに最適化された低遅延・低コストのサービスです。
- 料金体系は月間150,000文字まで無料、従量課金は 0.0005 USD/文字（≈0.075 円）で、エンタープライズプランは年契約割引あり。レートリミットは Standard プランで 1 分あたり 10,000 文字です。
- アカウント作成 → サービス有効化 → API キー取得 の流れは数分で完了し、キーは環境変数やシークレットマネージャーで安全に管理してください。
- リクエストは JSON POST、必須ヘッダーとともに送信し、成功時は
translatedTextが結果として返ります。エラーは HTTP ステータスコードとerrorMessageで判別し、429 超過時は指数的バックオフを実装します。 - コストシミュレーションでは、30 万文字/月で約 11,250 円、100 万文字/月で約 63,750 円と、無料枠活用すれば小規模プロジェクトはほぼ無償です。Google や DeepL と比べて価格優位ですが、対応言語数が限定的な点は留意が必要です。
- ベストプラクティスとしてバッチ送信・キャッシュ・非同期処理を組み合わせ、キー管理・暗号化・監査ログでセキュリティを確保すれば、安定した翻訳基盤が構築できます。
これらの情報を元に、プロジェクト要件と予算に最適な Papago 翻訳 API の導入計画をご検討ください。
参考リンク
[^1]: Naver Cloud 「Papago Translation」公式ページ – Supported Languages (2026‑05 更新)
[^2]: Naver Cloud 「Papago Translation API ガイド」 – Rate Limit セクション (2026‑04 版)
[^3]: Naver Cloud 利用規約・ブランド表示ガイドライン (2026‑03)