---
title: "テキストの翻訳"
slug: "ai-naver-papagonmt-translation"
tags: ["Papago Translation"]
updated: 2026-09-17T09:57:14Z
published: 2026-09-17T09:57:14Z
canonical: "api.ncloud-docs.com/ai-naver-papagonmt-translation"
---

> ## 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.

# テキストの翻訳

Classic/VPC環境で利用できます。

入力されたテキストを翻訳して出力します。用語集機能(Glossary)、敬語翻訳(Honorific translation)、置換(Term replacement)オプションを利用すると出力結果を補うことができます。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| POST | /translation |

### リクエストヘッダ

Papago Translation APIで共通して使用されるヘッダの詳細は、[Papago Translationのリクエストヘッダ](/docs/ja/ai-naver-papagonmt#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストボディ

リクエストボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `source` | String | Required | 原本テキスト(Source)の言語コード - `auto`(自動言語検出) \| `ko(韓国語)` \| `en(英語)` \| `ja(日本語)` \| `zh-CN`(中国語(簡体字)) \| `zh-TW`(中国語(繁体字)) \| `vi`(ベトナム語) \| `th`(タイ語) \| `id`(インドネシア語) \| `fr`(フランス語) \| `es`(スペイン語) \| `ru`(ロシア語) \| `de`(ドイツ語) \| `it`(イタリア語) |
| `target` | String | Required | 翻訳後テキスト(Target)の言語コード - `ko(韓国語)` \| `en(英語)` \| `ja(日本語)` \| `zh-CN`(中国語(簡体字)) \| `zh-TW`(中国語(繁体字)) \| `vi`(ベトナム語) \| `th`(タイ語) \| `id`(インドネシア語) \| `fr`(フランス語) \| `es`(スペイン語) \| `ru`(ロシア語) \| `de`(ドイツ語) \| `it`(イタリア語) - 翻訳可能な言語ペアに関する情報は[翻訳可能な言語](/docs/ja/ai-naver-papagonmt-translation#%EB%B2%88%EC%97%AD%EC%A7%80%EC%9B%90%EC%96%B8%EC%96%B4)を参照 |
| `text` | String | Required | 翻訳対象のテキスト - 1回の呼び出しで最大5,000文字まで翻訳可能 |
| `glossaryKey` | String | Optional | 用語集 ID - 用語集データに基づいて置換翻訳を適用 - 韓国語⇔英語、日本語、中国語(簡体字/繁体字)、フランス語 \|英語⇔日本語、中国語(簡体字/繁体字)、ベトナム語、タイ語、インドネシア語、フランス語\| 日本語⇔中国語(簡体字/繁体字) - `replaceInfo`と同時に使用すると`replaceInfo`が優先 - 用語集の用語には`honorific`(敬語)を適用しない |
| `replaceInfo` | String | Optional | 置換翻訳インデックス - 特定のインデックス(`str`)を目的のテキストに一括翻訳 - `str`が設定されていない場合、原文を返す - 韓国語⇔英語、日本語、中国語(簡体字/繁体字)、フランス語 \|英語⇔日本語、中国語(簡体字/繁体字)、ベトナム語、タイ語、インドネシア語、フランス語\|日本語⇔中国語(簡体字/繁体字) |
| `honorific` | Boolean | Optional | 敬語を適用するかどうか - `true` \| `false`(デフォルト) - `true`: 敬語を適用 - `false`: 敬語を適用しない - 英語⇒韓国語、日本語⇒韓国語、中国語(簡体字/繁体字)⇒韓国語、韓国語⇒日本語、英語⇒日本語、中国語(簡体字/繁体字)⇒日本語 |

参考

翻訳対象外テキストを HTML <span>タグ(Tag)で次のように指定することもできます。

```
<span translate="no"></span>または<span class="notranslate"> </span>
```

タグは文字数に含まれません。`glossaryKey`と`replaceInfo`のサポート言語は同じです。<span> タグのユースケースは[Text Translationのユースケース](/docs/ja/ai-naver-papagonmt-translation#/docs/ja/ai-naver-papagotranslation-example01#%EC%B9%98%ED%99%98%EC%98%B5%EC%85%98%EC%A0%81%EC%9A%A9)をご参照ください。

#### 翻訳可能な言語

翻訳可能な言語の説明は次の通りです。

| サポート言語 | 翻訳方向 | サポート言語 |
| --- | --- | --- |
| `ko`(韓国語) | ⇔ | `en`(英語)、`ja`(日本語)、`zh-CN`(中国語(簡体字))、`zh-TW`(中国語(繁体字))、`vi`(ベトナム語)、`th`(タイ語)、`id`(インドネシア語)、`fr`(フランス語)、`es`(スペイン語)、`ru`(ロシア語)、`de`(ドイツ語)、`it`(イタリア語) |
| `en`(英語) | ⇔ | `ko`(韓国語)、`ja`(日本語)、`zh-CN`(中国語(簡体字))、`zh-TW`(中国語(繁体字))、`vi`(ベトナム語)、`th`(タイ語)、`id`(インドネシア語)、`fr`(フランス語)、`es`(スペイン語)、`ru`(ロシア語)、`de`(ドイツ語) |
| `ja`(日本語) | ⇔ | `zh-CN`(中国語(簡体字))、`zh-TW`(中国語(繁体字))、`vi`(ベトナム語)、`th`(タイ語)、`id`(インドネシア語)、`fr`(フランス語) |
| `zh-CN`(中国語(簡体字)) | ⇔ | `zh-TW`(中国語(簡体字)) |

### リクエスト例

リクエストのサンプルコードは次の通りです。

#### `Content-Type: application/x-www-form-urlencoded`の場合

リクエストヘッダ`Content-Type`が`application/x-www-form-urlencoded`の場合のリクエストのサンプルコードは次の通りです。

```
curl --location --request POST
'https://papago.apigw.ntruss.com/nmt/v1/translation' \
--header 'X-NCP-APIGW-API-KEY-ID: {アプリの登録時に発行された Client ID}' \
--header 'X-NCP-APIGW-API-KEY: {アプリの登録時に発行された Client Secret}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'source=auto' \
--data-urlencode 'target=en' \
--data-urlencode 'text=こんにちは。私は自転車に乗りながらリンゴを食べるのが好きです。'
```

#### `Content-Type: application/json`の場合

リクエストヘッダ`Content-Type`が`application/json`の場合のリクエストのサンプルコードは次の通りです。

```
curl --location --request POST
'https://papago.apigw.ntruss.com/nmt/v1/translation' \
--header 'X-NCP-APIGW-API-KEY-ID: {アプリの登録時に発行された Client ID}' \
--header 'X-NCP-APIGW-API-KEY: {アプリの登録時に発行された Client Secret}' \
--header 'Content-Type: application/json' \
--data '{
    "source": "auto",
    "target": "ko",
    "text": "Advanced technology requires numerous beta tests and feedbacks. This process takes up a lot of time, but it must be done for development.",
    "glossaryKey": "{glossaryKey}",
    "replaceInfo": " ",
    "honorific": "true"
}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `message` | Object | - | レスポンス結果 |
| `message.result` | Object | - | 翻訳結果の詳細情報 |
| `message.result.srcLangType` | String | - | 原本テキストの言語コード |
| `message.result.tarLangType` | String | - | 翻訳結果のテキストの言語コード |
| `message.result.translatedText` | String | - | 翻訳結果のテキスト |

### レスポンスステータスコード

Papago Translation APIで共通して使用されるレスポンスステータスコードの詳細は、[Papago Translationのレスポンスステータスコード](/docs/ja/ai-naver-papagonmt#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
{
    "message": {
        "result": {
            "srcLangType": "ko",
            "tarLangType": "en",
            "translatedText": "Hello, I like to eat apple while riding a bicycle."
        }
    }
}
```