---
title: "CLOVA Speech Recognition (CSR) 개요"
slug: "ai-naver-clovaspeechrecognition"
tags: ["CLOVA Speech Recognition", "CSR"]
updated: 2026-09-17T09:10:00Z
published: 2026-09-17T09:10:00Z
canonical: "api-fin.ncloud-docs.com/ai-naver-clovaspeechrecognition"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLOVA Speech Recognition (CSR) 개요

사람의 목소리를 인식하여 작동하는 비서 애플리케이션, 챗봇, 음성 메모 등의 서비스를 만들 때 활용할 수 있는 음성 인식 API 서비스입니다. 음성 데이터는 API를 통해 CLOVA Speech Recognition(CSR) 엔진으로 전송되며, 해당 음성 데이터를 인식해서 텍스트로 변환하여 전달해줍니다.

## 공통 설정

클라이언트 아이디는 [NAVER Cloud Platform 콘솔](https://console.fin-ncloud.com/)에서 애플리케이션을 등록해 발급받습니다.

1. 콘솔의 **AI·NAVER API > AI·NAVER API > Application**에서 애플리케이션을 등록합니다. **[자세한 방법 보기](https://guide-fin.ncloud-docs.com/docs/naveropenapiv3-application) >**
2. **AI·NAVER API > AI·NAVER API > Application**에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
3. **AI·NAVER API > AI·NAVER API > Application**의 **변경** 화면에서 **CLOVA Speech Recognition**가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

## STT API 사용하기

STT API는 REST API이며, 음성인식할 음성 데이터를 HTTP 통신으로 음성인식 서버에 전달하면 됩니다. 음성인식 서버가 제공하는 REST API의 URI는 다음과 같으며 POST 방식으로 연결을 시도해야 합니다.

### API URL

| Method | Request URI |
| --- | --- |
| POST | `https://naveropenapi.apigw-pub.fin-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 | content-length 초과 (10MB) |
| 503 | 500 | Endpoint Error | 엔드포인트 연결오류 |
| 504 | 510 | Endpoint Timeout | 엔드포인트 연결시간 초과 |
| 500 | 900 | Unexpected Error | 예외처리가 안된 오류 |

#### API 오류

| 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 | 알 수 없는 오류 발생 고객지원을 통해 문의하면 신속히 조치 예정 |