---
title: "CLOVA Voiceの概要"
slug: "ai-naver-clovavoice"
tags: ["overview", "CLOVA Voice"]
updated: 2026-09-17T09:57:20Z
published: 2026-09-17T09:57:20Z
canonical: "api.ncloud-docs.com/ai-naver-clovavoice"
---

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

# CLOVA Voiceの概要

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

CLOVA Voiceは、多様で自然な高品質の音声合成技術を提供する NAVERクラウドプラットフォームのサービスです。CLOVA Voiceサービスでは、TTS(Text-to-Speech)機能関連の APIを RESTful形式で提供します。

## CLOVA Voiceの共通設定

CLOVA Voice APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

#### API URL

リクエスト API URLは次の通りです。

```
https://naveropenapi.apigw.ntruss.com/tts-premium/v1
```

#### リクエストヘッダ

ヘッダの説明は次の通りです。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-apigw-api-key-id` | Required | NAVERクラウドプラットフォームコンソールで Application登録後に発行された Client ID |
| `x-ncp-apigw-api-key` | Required | NAVERクラウドプラットフォームコンソールで Application登録後に発行された Client Secret |
| `Content-Type` | Required | リクエストデータの形式 - `application/x-www-form-urlencoded` |

              参考

              

NAVERクラウドプラットフォームコンソールで Applicationを登録して APIの使用に必要な認証情報(Client ID、Client Secret)を発行する方法はの詳細は、[CLOVA Voiceご利用ガイド](https://guide.ncloud-docs.com/docs/ja/clovavoice-start)をご参照ください。 コンソールで Applicationを登録した後に APIが選択されているか **[変更]** ボタンをクリックして確認してください。選択されていないと429(Quota Exceed)エラーが発生します。

### レスポンス

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

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

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 400 | VS01 | speaker parameter is needed. | `speaker`パラメータが入力されていない |
| 400 | VS02 | Unsupported speaker. | サポートしない`speaker`パラメータ |
| 400 | VS03 | Speed parameter is needed. | `speed`パラメータが入力されていない |
| 400 | VS04 | Unsupported speed. | サポートしない`speed`パラメータ |
| 400 | VS05 | text parameter is needed. | `text`パラメータが入力されていない |
| 400 | VS06 | text parameter exceeds max length. | `text`パラメータが入力文字数超過 |
| 400 | VS07 | Unsupported volume. | 入力されたボリューム(`volume`)パラメータをサポートしない |
| 400 | VS08 | Unsupported pitch. | 入力された高低(`pitch`)パラメータをサポートしない |
| 400 | VS09 | Unsupported alpha. | 入力された音色(`alpha`)パラメータをサポートしない |
| 400 | VS10 | Text parameter check. | 入力された文(`text`)パラメータは合成不可 |
| 400 | VS11 | Unsupported format. | 入力された形式(`format`)パラメータをサポートしない |
| 400 | VS14 | Unsupported emotion value. | 入力された感情(`emotion`)パラメータをサポートしない |
| 400 | VS18 | Text parameter exceeds max length per sentence. | 1文当たりの最大文字数(200文字)を超過 |
| 400 | VS19 | Unsupported emotion-strength. | 入力された感情の強度(`emotion-strength`)パラメータをサポートしない |
| 400 | VS26 | Failed to make tts. | TTS作成失敗 |
| 400 | VS46 | Unsupported end-pitch. | 入力された終音処理(`end-pitch`)パラメータをサポートしない |
| 500 | VS99 | Internal server error | 内部サーバエラー - カスタマーサポートに問い合わせる |

              参考

              

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)をご参照ください。

## CLOVA Voice API

CLOVA Voiceサービスで提供する APIの説明は次の通りです。

| API | 説明 |
| --- | --- |
| [TTS (Preminum)](/docs/ja/ai-naver-clovavoice-ttspremium) | テキストを音声に合成 |

## CLOVA Voice関連リソース

CLOVA Voice APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

- CLOVA Voice APIの使用方法
  - [APIの概要](/docs/ja/common-ncpapi): NAVERクラウドプラットフォームから発行された Access Key、Secret Keyの発行と確認、リクエストヘッダに必要な署名の作成方法
  - [API Gatewayご利用ガイド](https://guide.ncloud-docs.com/docs/ja/apigw-apigw-1): リクエストヘッダに必要な API Keyの確認方法
  - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3-%EC%9D%91%EB%8B%B5-%EC%83%81%ED%83%9C-%EC%BD%94%EB%93%9C): CLOVA Voiceサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- CLOVA Voiceサービスの使用方法
  - [CLOVA Voiceご利用ガイド](https://guide.ncloud-docs.com/docs/ja/clovavoice-overview): NAVERクラウドプラットフォームコンソールで CLOVA Voiceを使用する方法
  - [Ncloud使用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境とサポート有無に関するガイド
  - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/aiService/clovaVoice): CLOVA Voiceの料金体系、特徴、詳細機能のサマリー
  - [サービス関連の最新のお知らせ](https://www.ncloud.com/intro/news): CLOVA Voice関連の最新共有ニュース
  - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=APP&categoryCode3=SV_0067): CLOVA Voiceユーザーからのよくある質問
  - [お問い合わせ](https://www.ncloud.com/support/question/service): ご利用ガイドだけでは不明な点が解消されない場合、直接お問い合わせ