--- title: "STT (Speech-to-Text)" slug: "ai-naver-clovaspeechrecognition-stt" updated: 2026-09-17T09:57:20Z published: 2026-09-17T09:57:20Z canonical: "api.ncloud-docs.com/ai-naver-clovaspeechrecognition-stt" --- > ## 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. # STT (Speech-to-Text) Classic/VPC環境で利用できます。 音声認識に使用する言語と MP3、AAC、AC3、OGG、FLAC、WAV形式の音声データの入力を受け、その認識結果をテキストに変換します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | POST | /stt | ### リクエストヘッダ CLOVA Speech Recognition (CSR) APIで共通して使用されるヘッダの詳細は、[CLOVA Speech Recognition (CSR)の共通ヘッダ](/docs/ja/ai-naver-clovaspeechrecognition#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `lang` | String | Required | 変換後テキストの言語 - `Kor` \| `Eng` \| `Jpn` \| `Chn` - `Kor`: 韓国語 - `Eng`: 英語 - `Jpn`: 日本語 - `Chn`: 中国語(簡体字) | ### リクエストボディ リクエストボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | 変換対象の音声データ | Binary | Required | MP3、AAC、AC3、OGG、FLACまたは WAV形式のバイナリ音声データ - 再生時間は最大60秒 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request POST 'https://naveropenapi.apigw.ntruss.com/recog/v1/stt ?lang=Kor' \ --header 'x-ncp-apigw-api-key-id: {アプリの登録時に発行された Client ID}' \ --header 'x-ncp-apigw-api-key: {アプリの登録時に発行された Client Secret}' \ --header 'Content-Type: application/octet-stream' \ --data '@{file}' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `text` | String | - | 音声ファイルから変換されたテキスト | ### レスポンスステータスコード CLOVA Speech Recognition(CSR) APIで共通して使用されるレスポンスステータスコードの詳細は、[CLOVA Speech Recognition (CSR)の共通レスポンスステータスコード](/docs/ja/ai-naver-clovaspeechrecognition#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` { "text": "こんにちは" } ```