--- title: "Papago Translationの概要" slug: "ai-naver-papagonmt" tags: ["Papago Translation"] updated: 2026-09-17T09:57:14Z published: 2026-09-17T09:57:14Z canonical: "api.ncloud-docs.com/ai-naver-papagonmt" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Papago Translationの概要 Classic/VPC環境で利用できます。 Papago Translationは、ニューラルネットワーク基盤の機械翻訳(Neural Machine Translation)アルゴリズムで多言語(ソース)をターゲット言語に自動翻訳する NAVERクラウドプラットフォームのサービスです。テキスト翻訳、文書翻訳、ウェブ翻訳、言語検出、用語集機能関連の APIを RESTful形式で提供します。 参考 Papago Translation APIはユーザーの原文データを保存したり、学習データとして活用することは致しません。 ## Papago Translationの共通設定 Papago Translation APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。 ### リクエスト 共通リクエスト形式を説明します。 #### API URL リクエスト API URLは次の通りです。 ``` Text Translation: https://papago.apigw.ntruss.com/nmt/v1 Doc Translation: https://papago.apigw.ntruss.com/doc-trans/v1 Website Translation: https://papago.apigw.ntruss.com/web-trans/v1 Language Detection: https://papago.apigw.ntruss.com/langs/v1 Glossary: https://papago.apigw.ntruss.com/glossary ``` #### リクエストヘッダ ヘッダの説明は次の通りです。 | フィールド | 必須の有無 | 説明 | | --- | --- | --- | | `x-ncp-apigw-api-key-id` | Required | NAVERクラウドプラットフォームコンソールで Application登録後に発行された Client ID | | `x-ncp-apigw-api-key` | Required | NAVERクラウドプラットフォームコンソールで Application登録後に発行された Client Secret | | `Content-Type` | Conditional | クライアントが処理可能なデータタイプ - `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` | 参考 NAVERクラウドプラットフォームコンソールで Applicationを登録して APIの使用に必要な認証情報(Client ID、Client Secret)を発行する方法はの詳細は、Papago Translationご利用ガイドの[APIs](https://guide.ncloud-docs.com/docs/ja/papagotranslation-use-apis#Application%EB%93%B1%EB%A1%9D)をご参照ください。 コンソールで Applicationを登録した後に Papago Translation APIを選択しないと、429(Quota Exceed)エラーが発生します。 ### レスポンス 共通レスポンス形式を説明します。 #### レスポンスステータスコード レスポンスステータスコードの説明は次の通りです。 参考 NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 **Text Translation** Text Translationで使用されるレスポンスステータスコードの説明は次の通りです。 | HTTPステータスコード | コード | メッセージ | 説明 | | --- | --- | --- | --- | | 400 | N2MT01 | source parameter is needed | `source`パラメータ漏れ | | 400 | N2MT02 | Unsupported source language | `source`をサポートしない | | 400 | N2MT03 | target parameter is needed | `target`パラメータ漏れ | | 400 | N2MT04 | Unsupported target language | `target`をサポートしない | | 400 | N2MT05 | source and target must be different | `source`と`target`が同じ | | 400 | N2MT06 | There is no source-to-target translator | `source` ⇒ `target`翻訳機がない | | 400 | N2MT07 | text parameter is needed | `text`パラメータ漏れ | | 400 | N2MT08 | text parameter exceeds max length | `text`パラメータが最大サイズを超過 | | 400 | N2MT09 | language detection failed | 言語検出失敗 | | 400 | N2MT10 | invalid glossary key | 無効な`glossayKey` | | 500 | N2MT99 | Internal server errors | サーバ内部エラー | **Doc Translation** Doc Translationで使用されるレスポンスステータスコードの説明は次の通りです。 | HTTPステータスコード | コード | メッセージ | 説明 | | --- | --- | --- | --- | | 400 | 00001 | Request is invalid | 無効なパラメータが存在 | | 400 | 00006 | API call failed | サポートしない言語ペアまたはファイル拡張子でリクエスト | | 401 | 25003 | requestId is invalid | - | | 404 | 25006 | Not Found | - | | 413 | 25004 | Request Entity Too Large | 有効なファイルサイズ超過(最大100MB) | | 429 | 25005 | Too many requests | 同時翻訳リクエスト数超過 | | 500 | 00000 | API call failed | サーバ内部エラー | | 500 | 25001 | API call failed | サーバ内部エラー | | - | 01 | Error upload file to server | ファイルアップロードに失敗 | | - | 10 | Translated Doc is empty | 文書に文字がない | | - | 11 | Translated Docs length exceeded max-len | 文書ファイルが翻訳可能な文字数を超過 | | - | 15 | Parsing is not possible | パースライブラリ失敗(翻訳不可ファイル) | | - | 16 | Unsupported source language | サポートしないソース言語 | | - | 17 | Detected langcode is the same as target langcode | ソース言語とターゲット言語が同じ | | - | 18 | Language detection failed | 言語検出失敗 | | - | 34 | maximum output size exceeded | パーサーの容量超過 | | - | 36 | PDF Resolution Error | サポートする解像度を超過 | | - | 37 | the target language is the same as the source language | ソース言語とターゲット言語が同じ | | - | 38 | invalid glossary key | 無効な`glossayKey` | | - | 39 | pdf page length exceeded max size | 文書ファイルが翻訳可能なページ数を超過 | | - | 41 | invalid hwpx file | 無効な文書 | | - | 50 | internal parser error | 内部パーサーエラー | | - | 60 | internal server error | サーバ内部エラー | **Website Translation** Website Translationで使用されるレスポンスステータスコードの説明は次の通りです。 | HTTPステータスコード | コード | メッセージ | 説明 | | --- | --- | --- | --- | | 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`をサポートしない | | 400 | N2MT05 | invalid glossary key | 無効な用語集キー | | 500 | 00000 | API call failed | サーバ内部エラー | **Language Detection** Language Detectionで使用されるレスポンスステータスコードの説明は次の通りです。 | HTTPステータスコード | コード | メッセージ | 説明 | | --- | --- | --- | --- | | 400 | LD01 | Empty text | 言語検出対象の`text`がない | | 400 | LD01 | Empty query parameter | 言語検出対象の`text`がない | | 400 | LD03 | Query parameter exceeds max length | 言語検出対象の`text`が長さ制限を超えている(最大5,000文字) | | 500 | LD99 | Internal server errors | サーバ内部エラー | **Glossary** Glossaryで使用されるレスポンスステータスコードの説明は次の通りです。 | HTTPステータスコード | コード | メッセージ | 説明 | | --- | --- | --- | --- | | 204 | - | - | 用語集削除完了 | | 400 | - | - | 無効なリクエスト | | 400 | 10000 | INVALID_REQUEST | 無効なリクエスト(必須パラメータの欠落など) | | 400 | 20000 | NOT_FOUND_GLOSSARY | 用語集が見つからない | | 400 | 20004 | INVALID_GLOSSARY_KEY | 無効な`glossayKey` | | 400 | 30000 | COUNT_LIMIT_OVER | 用語登録件数制限を超過 | | 400 | 30005 | UNSUPPORTED_LANG | サポートしない言語 | | 400 | 30006 | SAME_SOURCE_TARGET | sourceと target言語が同じ | | 400 | 30008 | Replacer already exists | 既に登録済みの用語 | | 400 | 30009 | Unsupported character: , | 入力できない記号の`,`を含む | | 400 | 30013 | INVALID_ARRAY_SIZE | 配列が空であるか、20個を超える | | 400 | 30014 | INVALID_REPLACER_ID | 用語が見つからない(無効な ID) | | 500 | 10001 | NTERNAL_ERROR | サーバエラー | ## Papago Translation API Papago Translationサービスで提供する APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [Text Translation > translation](/docs/ja/ai-naver-papagonmt-translation) | テキストを翻訳 | | [Doc Translation > translation](/docs/ja/ai-naver-papagodoctranslation-translate) | 文書を翻訳 | | [Doc Translation > status](/docs/ja/ai-naver-papagodoctranslation-status) | 文書の翻訳状態を確認 | | [Doc Translation > download](/docs/ja/ai-naver-papagodoctranslation-download) | 文書翻訳の結果をダウンロード | | [Website Translation > website translation](/docs/ja/ai-naver-papagowebsitetranslation-translation) | ウェブ翻訳 | | [Language Detection > detect](/docs/ja/ai-naver-papagolanguagedetection-dect) | 言語検出 | | [Glossary > create](/docs/ja/papago-createglossary) | 用語集を作成 | | [Glossary > upload](/docs/ja/papago-updateglossaryfile) | 用語集ファイルをアップロード | | [Glossary > download](/docs/ja/papago-downloadglossaryfile) | 用語集ファイルをダウンロード | | [Glossary > get](/docs/ja/papago-glossarylist) | 用語集リストを照会 | | [Glossary > delete](/docs/ja/papago-deleteglossary) | 用語集を削除 | ## Papago Translation関連リソース Papago Translation APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。 - Papago Translation APIの使用方法 - [署名(シグネチャー)の作成](/docs/ja/common-ncpapi#1-%EC%9D%B8%EC%A6%9D%ED%82%A4-%EC%83%9D%EC%84%B1): リクエストヘッダに追加する署名の作成方法 - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): Papago Translationサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報 - [Cloud Insightご利用ガイド](https://guide.ncloud-docs.com/docs/ja/cloudinsight-cloudinsightoverview): Application使用上限通知設定に必要な Cloud Insightの申し込み方法と通知対象者の追加方法の案内 - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): Papago Translationの運用権限管理をサポートする Sub Accountの使用方法の案内 - Papago Translationサービスの使用方法 - [Papago Translationご利用ガイド](https://guide.ncloud-docs.com/docs/ja/papagotranslation-overview): NAVERクラウドプラットフォームコンソールでの Applicationの登録、用語集の管理、使用量の確認と通知設定の方法 - [Papago Translationを使用する前に](https://guide.ncloud-docs.com/docs/ja/papagotranslation-spec): Papago Translationでサポートする環境スペック、使用時の留意事項、利用料金のご案内 - [Ncloud使用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境とサポートの有無に関するご利用ガイド - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/aiService/papagoTranslation): Papago Translationの料金体系、Papago Translationの特徴と詳細機能のサマリー - [サービスのお知らせ](https://www.ncloud.com/intro/news): Papago Translationに関するお知らせ - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=AI&categoryCode3=SV_0055&page=1): Papago Translationに関するよくあるご質問 - [お問い合わせ](https://www.ncloud.com/support/question/service): ガイドだけでは不明な点が解消されない場合、直接お問い合わせ