---
title: "ルーター"
slug: "clovastudio-router"
updated: 2026-09-17T09:57:20Z
published: 2026-09-17T09:57:20Z
canonical: "api.ncloud-docs.com/clovastudio-router"
---

> ## 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環境で利用できます。

特定のルーターの APIを呼び出して入力されたリクエストを適切なドメインに分類し、設定されたフィルタ条件を満たすかかどうか判別します。

## リクエスト

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

| メソッド | URI |
| --- | --- |
| POST | /v1/routers/{router-id}/versions/{version}/route |

### リクエストヘッダ

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

### リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `router-id` | String | Required | ルーター ID |
| `version` | Integer | Required | ルーターのバージョン - 1 ≤ `version` |

### リクエストボディ

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `query` | String | Required | 入力 |
| `chatHistory` | Array | Optional | 会話メッセージ履歴: [chatHistory](/docs/ja/clovastudio-router#chatHistory) |

#### `chatHistory`

`chatHistory`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `role` | Enum | Required | 会話メッセージのロール - `user`: ユーザーの発話/質問 |
| `content` | String | Required | 会話メッセージの内容 |

### リクエスト例

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

```
curl --location --request POST 'https://clovastudio.stream.ntruss.com/v1/routers/{router-id}/versions/{version}/route' \
--header 'Authorization: Bearer {API Key}' \
--header 'X-NCP-CLOVASTUDIO-REQUEST-ID: {Request ID}' \
--header 'Content-Type: application/json' \
--data '{
  "query" : "PM2.5情報を教えて",
  "chatHistory" : [ {
    "role" : "user",
    "content" : "明日のソウルの降水予報を教えて"
  } ]
}'
```

## レスポンス

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

### レスポンスヘッダ

レスポンスヘッダの説明は次の通りです。

| ヘッダ | 必須の有無 | 説明 |
| --- | --- | --- |
| Content-Type | - | レスポンスデータの形式 - `application/json` |

### レスポンスボディ

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `status` | Object | - | [レスポンスステータス](/docs/ja/ai-naver-clovastudio-summary#%EC%9D%91%EB%8B%B5) |
| `result` | Object | - | レスポンス結果 |
| `result.domain` | Object | - | ドメイン結果 |
| `result.domain.result` | String | - | ドメインの判別結果 - 一致するドメインがない場合、空の文字列を表示 |
| `result.domain.called` | Boolean | - | ドメインの判別を実行するかどうか - `true` \| `false` - `true`: 実行 - `false`: 実行しない |
| `result.blockedContent` | Object | - | コンテンツフィルタ結果 |
| `result.blockedContent.result` | Array | - | コンテンツフィルタの判別結果 - 一致するフィルタがない場合、空のリストを表示 |
| `result.blockedContent.called` | Boolean | - | コンテンツフィルタの判別を実行するかどうか - `true` \| `false` - `true`: 実行 - `false`: 実行しない |
| `result.safety` | Object | - | セーフティフィルタの結果 |
| `result.safety.result` | Array | - | セーフティフィルタの判別結果 - 一致するフィルタがない場合、空のリストを表示 |
| `result.safety.called` | Boolean | - | セーフティフィルタの判別を実行するかどうか - `true` \| `false` - `true`: 実行 - `false`: 実行しない |
| `result.usage` | Object | - | トークン数情報 |
| `result.usage.promptTokens` | Integer | - | 入力トークン数 |
| `result.usage.completionTokens` | Integer | - | 生成トークン数 |
| `result.usage.totalTokens` | Integer | - | トークンの総数 - `promptTokens` + `completionTokens` |

### レスポンス例

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

#### 成功

呼び出しに成功した場合のレスポンスのサンプルコードは次の通りです。

```
{
  "status": {
    "code": "20000",
    "message": "OK"
  },
  "result": {
    "domain": {
      "result": "地域検索",
      "called": true
    },
    "blockedContent": {
      "result": ["UnsupportedRegion"],
      "called": true
    },
    "safety": {
      "result": [],
      "called": true
    },
    "usage": {
      "promptTokens": 425,
      "completionTokens": 62,
      "totalTokens": 487
    }
  }
}
```

#### 失敗

呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

- [クライアント共通エラー問題(4xx)](/docs/ja/clovastudio-troubleshoot-c4xx)
- [クライアントスキルエラー問題(4xx)](/docs/ja/clovastudio-troubleshoot-s4xx)
- [サーバ共通エラー問題(5xx)](/docs/ja/clovastudio-troubleshoot-c5xx)
- [サーバスキルエラー問題(5xx)](/docs/ja/clovastudio-troubleshoot-s5xx)