CLOVA Speech Recognition(CSR)概要

Article Summary

Share feedback

Thanks for sharing your feedback!

人の声を認識して動作する秘書アプリケーション、chatbot、音声メモなどのサービスを作る時に活用できる音声認識APIサービスです。音声データはAPIを通じてCLOVA Speech Recognition(CSR)エンジンに伝送されるし、該当音声データを認識し、テキストに変換して伝達します。

共通設定

Client IDは Naverクラウドプラットフォームコンソールでアプリケーションを登録して発行します。

コンソールのAI·NAVER API > AI·NAVER API > Applicationでアプリケーションを登録します。 詳しい方法の確認 >
AI·NAVER API > AI·NAVER API > Applicationで登録したアプリケーションを選択してClient IDとClient Secretの値を確認します。
AI·NAVER API > AI·NAVER API > Applicationの [変更] 画面で CLOVA Speech Recognitionが選択されていることを確認します。選択されてない場合は429 (Quota Exceed)が発生するのでご注意をお願いします。

STT APIはREST APIであり、音声認識する音声データをHTTP通信で音声認識サーバに送信することで実行されます。音声認識サーバが提供するREST APIのURIは以下のようであり、POST方式で連結を試す必要があります。

Method	Request URI
POST	`https://naveropenapi.apigw.ntruss.com/recog/v1/stt`

ヘッダ名	説明
X-NCP-APIGW-API-KEY-ID	アプリケーションを登録する時に発行されたClient ID `X-NCP-APIGW-API-KEY-ID:{Client ID}`
X-NCP-APIGW-API-KEY	アプリケーションを登録する時に発行されたClient Secret `X-NCP-APIGW-API-KEY:{Client Secret}`
Content-Type	application/octet-streamに固定 `Content-Type: application/octet-stream`

{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}

HttpStatusCode	ErrorCode	ErrorMessage	Description
400	100	Bad Request Exception	protocol(https), endocing(UTF-8) など requestエラー
401	200	Authentication Failed	認証失敗
401	210	Permission Denied	権限なし
404	300	Not Found Exception	権限なし
429	400	Quota Exceeded	Quota超過
429	410	Throttle Limited	Rate超過
429	420	Rate Limited	Rate超過
413	430	Request Entity Too Large	conent-length超過 (10MB)
503	500	Endpoint Error	エンドポイント連結エラー
504	510	Endpoint Timeout	エンドポイント連結時間超過
500	900	Unexpected Error	例外処理がされてないエラー

HttpStatusCode	ErrorCode	ErrorMessage	Description
413	STT000	Request Entity Too Large	許容する音声データの容量を超えました。(最大3MB )
413	STT001	Exceed Sound Data length	許容する音声データの長さを超えました。 ( 60秒 )
400	STT002	Invalid Content Type	application/octet-stream以外のcontent-typeの場合に発生します。
400	STT003	Empty Sound Data	音声データが入力されてません。
400	STT004	Empty Language	言語パラメータが入力されてません。
400	STT005	Invalid Language	決まっている言語以外の言語値が入力されました。
500	STT006	Failed to pre-processing	音声認識の前処理中にエラーが発生しました。音声データが正常的なwav, mp3, flacであるかに対する確認が必要です。
500	STT998	Failed to STT	音声認識中にエラーが発生しました。速やかに対応しますのでお客様サポートまでお問い合わせください。
500	STT999	Internal Server Error	予期せぬエラーが発生しました。速やかに対応しますのでお客様サポートまでお問い合わせください。

この記事は役に立ちましたか?

タグ