CLOVA Voiceの概要

Prev Next

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ご利用ガイドをご参照ください。
コンソールで 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のレスポンスステータスコードをご参照ください。

CLOVA Voice API

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

API 説明
TTS (Preminum) テキストを音声に合成

CLOVA Voice関連リソース

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