--- title: "단문 인식 빌더" slug: "clovaspeech-builder-short" tags: ["CLOVA Speech"] updated: 2026-09-17T09:07:10Z published: 2026-09-17T09:07:10Z canonical: "guide.ncloud-docs.com/clovaspeech-builder-short" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 단문 인식 빌더 Classic/VPC 환경에서 이용 가능합니다. CLOVA Speech의 빌더를 사용하면 UI 환경으로 음성 인식 작업을 요청하고 관리할 수 있습니다. 빌더는 도메인별로 제공되며, 빌더에서는 다음과 같은 메뉴를 사용할 수 있습니다. - **데모** 메뉴: 인식 작업 등록 및 관리, 작업 결과 편집 및 내보내기 - **키워드 부스팅** 메뉴: 인식 확률을 높이고 싶은 단어를 키워드로 등록 및 등록한 키워드 관리 - **인식 결과 보정** 메뉴: 인식 결과를 후처리를 통해 보정 - **설정** 메뉴: 도메인의 정보 확인 참고 도메인 유형에 따라 일부 기능은 노출되지 않을 수 있습니다. ## 빌더 실행 빌더를 실행하는 방법은 다음과 같습니다. 참고 빌더를 사용하기 위해서는 먼저 도메인을 생성해야 합니다. 도메인 생성에 대한 자세한 내용은 [도메인 생성](/docs/clovaspeech-domain#%EB%8F%84%EB%A9%94%EC%9D%B8%EC%83%9D%EC%84%B1)을 참고해 주십시오. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI Services** > **CLOVA Speech** 메뉴를 차례대로 클릭해 주십시오. 2. **단문 인식** 유형의 **Domain** 메뉴를 클릭해 주십시오. 3. 빌더를 실행할 도메인의 **[빌더 실행]** 버튼을 클릭해 주십시오. ## 데모 빌더의 **데모** 메뉴에서 API Gateway 연동 없이 네이버 클라우드 플랫폼 콘솔에 음원을 업로드하여 단문 인식 데모 기능을 사용할 수 있습니다. 인식 결과는 화면으로 확인이 가능하며, 결과를 다운로드할 수 있습니다. 인식 시도 시 CLOVA Speech 1회 호출 이용 요금이 발생됩니다. 데모 화면은 다음과 같이 구성되어 있습니다. ![clovaspeech-builder_keyword_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/clovaspeech-short-demo2_ko.png?sv=2026-02-06&spr=https&st=2026-10-29T10%3A50%3A00Z&se=2026-10-29T11%3A50%3A00Z&sr=c&sp=r&sig=FGRtWtzRluu6UcJc3JOQ70QmlzH6448dx7%2BuvPWdro8%3D) | 영역 | 설명 | | --- | --- | | ① 메뉴명 | 현재 확인 중인 메뉴명 | | ② 언어 선택 | 인식 언어 선택(한국어, 영어, 일본어, 중국어)) | | ③ 업로드창 | 음원 업로드 화면 | | ④ 인식 결과 | 음원 인식 결과, 다운로드 | | ⑤ 발음평가 결과 | 단어, 문장 발음평가 결과 | 참고 - 발음평가 결과는 언어 설정이 **한국어, 영어**인 경우, 이용할 수 있습니다. - 발음평가 결과가 0.7 미만인 단어가 있는 경우, 단어에 **밑줄**을 표시하며, 마우스를 올려 단어의 상세 평가 결과를 확인할 수 있습니다. API Gateway 연동 없이 콘솔에서 CLOVA Speech 기능을 사용하려면 업로드 창에서 선택한 음원을 드래그 앤 드롭하거나 화면을 클릭하여 음원을 업로드해 주십시오. 업로드 시 확인해야 할 업로드 파일 기준은 다음과 같습니다. - 음원 파일 업로드 기준 - 크기: 10MB 이하 - 형식: mp3, aac, ac3, ogg, flac, wav 등 음원파일 - 음원길이: 60초 이하 ## 키워드 부스팅 키워드 부스팅을 통해 특정 단어에 대한 인식율을 높일 수 있습니다. **키워드 부스팅** 메뉴에서는 키워드를 등록하고 관리할 수 있습니다. ### 키워드 부스팅 화면 빌더 이용을 위한 **키워드 부스팅** 메뉴의 기본적인 설명은 다음과 같습니다. ![clovaspeech-builder_keyword_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/clovaspeech-short-keyword_ko.png?sv=2026-02-06&spr=https&st=2026-10-29T10%3A50%3A00Z&se=2026-10-29T11%3A50%3A00Z&sr=c&sp=r&sig=FGRtWtzRluu6UcJc3JOQ70QmlzH6448dx7%2BuvPWdro8%3D) | 영역 | 설명 | | --- | --- | | ① 메뉴명 | 현재 확인 중인 메뉴명 | | ② 키워드 등록 | 키워드 서버 배포 | | ③ 키워드 관리 기능 | 키워드 파일 업로드, 등록한 키워드 다운로드 및 삭제 | | ④ 검색창 | 키워드 검색 | | ⑤ 키워드 목록 | 조회 중인 키워드 목록 | ### 키워드 등록 추가한 키워드를 서버에 등록하는 방법은 다음과 같습니다. 1. 키워드를 추가해 주십시오. - 키워드 추가 화면에서 키워드를 등록합니다. 2. **[등록]** 버튼을 클릭해 주십시오. ### 키워드 추가 인식율을 높일 키워드를 추가하는 방법은 다음과 같습니다. 참고 - 최대 1,000 단어를 추가할 수 있으며, 한국어만 지원합니다. - 키워드는 500 단어 이하로 등록할 것을 권장하며, 500 단어 초과 시 성능 저하가 있을 수 있습니다. 다음 중 원하는 방식으로 키워드를 추가할 수 있습니다. - [키워드 파일 업로드](/docs/clovaspeech-builder-short#%ED%82%A4%EC%9B%8C%EB%93%9C%ED%8C%8C%EC%9D%BC%EC%97%85%EB%A1%9C%EB%93%9C): 키워드를 입력한 엑셀 파일을 업로드하여 여러 개의 키워드 일괄 추가 - [키워드 개별 추가](/docs/clovaspeech-builder-short#%ED%82%A4%EC%9B%8C%EB%93%9C%EA%B0%9C%EB%B3%84%EC%B6%94%EA%B0%80): 빌더에서 키워드를 입력하여 추가 #### 키워드 파일 업로드 키워드를 입력한 엑셀 파일을 업로드하여 여러 개의 키워드를 일괄 등록하는 방법은 다음과 같습니다. 1. 키워드를 입력한 엑셀 파일을 작성해 주십시오. - 4번 절차의 화면에서 **업로드 템플릿**을 클릭하면 키워드 파일의 템플릿을 확인할 수 있습니다. 2. 도메인의 빌더에서 **키워드 부스팅** 메뉴를 클릭해 주십시오. 3. **[업로드]** 버튼을 클릭해 주십시오. 4. 업로드 팝업 창이 나타나면 **마우스로 파일을 끌고 오거나 여기를 클릭하세요.** 영역에 로컬 PC에 있는 키워드 파일을 끌어넣거나 **마우스로 파일을 끌고 오거나 여기를 클릭하세요.** 영역을 클릭한 후 키워드 파일을 선택해 주십시오. 5. **[확인]** 버튼을 클릭해 주십시오. - 덮어씌우기: 체크 박스를 클릭해 선택하면 기존의 모든 키워드를 삭제하고 새로 키워드 등록 참고 키워드 파일에 기존의 키워드와 중복되는 키워드가 포함된 경우, 키워드 등록에 실패합니다. 중복된 키워드를 삭제하거나, 파일 업로드 시 덮어씌우기 체크 박스를 클릭해 주십시오. #### 키워드 개별 추가 빌더에서 키워드를 직접 추가하는 방법은 다음과 같습니다. 1. 도메인의 빌더에서 **키워드 부스팅** 메뉴를 클릭해 주십시오. 2. **추가할 키워드를 입력해주세요.** 영역을 클릭하여 키워드를 입력해 주십시오. 3. **[추가]** 버튼을 클릭해 주십시오. ### 키워드 수정 등록한 키워드를 수정하는 방법은 다음과 같습니다. 1. 도메인의 빌더에서 **키워드 부스팅** 메뉴를 클릭해 주십시오. 2. 키워드 목록에서 수정할 키워드의 ![i-clovaspeech-edit](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-edit.png?sv=2026-02-06&spr=https&st=2026-10-29T10%3A50%3A00Z&se=2026-10-29T11%3A50%3A00Z&sr=c&sp=r&sig=FGRtWtzRluu6UcJc3JOQ70QmlzH6448dx7%2BuvPWdro8%3D)을 클릭해 주십시오. 3. 키워드 입력란을 클릭하여 키워드를 수정한 후 ![i-clovaspeech-keywordeditcheck](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-keywordeditcheck.png?sv=2026-02-06&spr=https&st=2026-10-29T10%3A50%3A00Z&se=2026-10-29T11%3A50%3A00Z&sr=c&sp=r&sig=FGRtWtzRluu6UcJc3JOQ70QmlzH6448dx7%2BuvPWdro8%3D)을 클릭해 주십시오. - 키워드 수정을 취소하려면 ![i-clovaspeech-keywordeditcancel](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-keywordeditcancel.png?sv=2026-02-06&spr=https&st=2026-10-29T10%3A50%3A00Z&se=2026-10-29T11%3A50%3A00Z&sr=c&sp=r&sig=FGRtWtzRluu6UcJc3JOQ70QmlzH6448dx7%2BuvPWdro8%3D)을 클릭해 주십시오. ### 키워드 다운로드 등록된 키워드를 일괄 다운로드하는 방법은 다음과 같습니다. 1. 도메인의 빌더에서 **키워드 부스팅** 메뉴를 클릭해 주십시오. 2. 키워드 목록에서 다운로드할 키워드의 체크 박스를 클릭하여 선택해 주십시오. - 여러 키워드를 동시에 선택할 수 있습니다. 3. **[다운로드]** 버튼을 클릭해 주십시오. - 키워드와 가중치 정보를 포함한 엑셀 파일이 다운로드됩니다. ### 키워드 삭제 등록한 키워드를 삭제하는 방법은 다음과 같습니다. 1. 도메인의 빌더에서 **키워드 부스팅** 메뉴를 클릭해 주십시오. 2. 키워드 목록에서 삭제할 키워드의 체크 박스를 클릭하여 선택해 주십시오. - 여러 키워드를 동시에 선택할 수 있습니다. - 키워드의 **[삭제]** 버튼을 클릭하여 바로 키워드를 삭제할 수도 있습니다. 3. **[키워드 삭제]** 버튼을 클릭해 주십시오. 4. 알림 팝업 창이 나타나면 **[확인]** 버튼을 클릭해 주십시오. ## 인식 결과 보정 인식 결과 보정은 인식된 결과를 보정하여 표현할 수 있습니다. **인식결과보정** 메뉴에서는 메시지를 등록하고 관리할 수 있습니다. ### 인식 결과 보정 화면 빌더 이용을 위한 **인식 결과 보정** 메뉴의 기본적인 설명은 다음과 같습니다. ![clovaspeech-builder_keyword_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/clovaspeech-short-correction_ko.png?sv=2026-02-06&spr=https&st=2026-10-29T10%3A50%3A00Z&se=2026-10-29T11%3A50%3A00Z&sr=c&sp=r&sig=FGRtWtzRluu6UcJc3JOQ70QmlzH6448dx7%2BuvPWdro8%3D) | 영역 | 설명 | | --- | --- | | ① 메뉴명 | 현재 확인 중인 메뉴명 | | ② 메시지 등록 | 메시지 서버 배포 | | ③ 메시지 관리 기능 | 메시지 파일 업로드, 등록한 메시지 다운로드 및 삭제 | | ④ 검색창 | 메시지 검색 | | ⑤ 메시지 목록 | 조회 중인 메시지 목록 | ### 메시지 등록 추가한 메시지를 서버에 등록하는 방법은 다음과 같습니다. 1. 메시지를 추가하십오. - 아래 **메시지 추가** 화면에서따라 메시지를 등록해주십시오. 2. **등록** 버튼을 클릭해 주십시오. 참고 - 최대 50,000 행을 추가할 수 있으며, 한국어만 지원합니다. - 키워드는 40 단어 이하로 등록할 것을 권장합니다. ### 메시지 추가 보정하고자하는 메시지를 추가하는 방법은 다음과 같습니다. 다음 중 원하는 방식으로 메시지를 추가할 수 있습니다. - [메시지 파일 업로드](/docs/clovaspeech-builder-short#%EB%A9%94%EC%8B%9C%EC%A7%80%ED%8C%8C%EC%9D%BC%EC%97%85%EB%A1%9C%EB%93%9C): 메시지를 입력한 엑셀 파일을 업로드하여 여러 개의 메시지 일괄 추가 - [메시지 개별 추가](/docs/clovaspeech-builder-short#%EB%A9%94%EC%8B%9C%EC%A7%80%EA%B0%9C%EB%B3%84%EC%B6%94%EA%B0%80): 빌더에서 메시지를 입력하여 추가 #### 메시지 파일 업로드 메시지를 입력한 엑셀 파일을 업로드하여 여러 개의 메시지를 일괄 등록하는 방법은 다음과 같습니다. 1. 메시지를 입력한 엑셀 파일을 작성해 주십시오. - 4번 절차의 화면에서 **업로드 템플릿**을 클릭하면 메시지 파일의 템플릿을 확인할 수 있습니다. 2. 도메인의 빌더에서 **인식 결과 보정** 메뉴를 클릭해 주십시오. 3. **[업로드]** 버튼을 클릭해 주십시오. 4. 업로드 팝업 창이 나타나면 **마우스로 파일을 끌고 오거나 여기를 클릭하세요.** 영역에 로컬 PC에 있는 키워드 파일을 끌어넣거나 **마우스로 파일을 끌고 오거나 여기를 클릭하세요.** 영역을 클릭한 후 키워드 파일을 선택해 주십시오. 5. **[확인]** 버튼을 클릭해 주십시오. - 덮어씌우기: 체크 박스를 클릭해 선택하면 기존의 모든 키워드를 삭제하고 새로 키워드 등록 참고 키워드 파일에 기존의 메시지와 중복되는 메시지가 포함된 경우, 메시지 등록에 실패합니다. 중복된 메시지를 삭제하거나, 파일 업로드 시 덮어씌우기 체크 박스를 클릭해 주십시오. #### 메시지 개별 추가 빌더에서 메시지를 직접 추가하는 방법은 다음과 같습니다. 1. 도메인의 빌더에서 **인식 결과 보정** 메뉴를 클릭해 주십시오. 2. **메시지 입력창** 에 필요한 메시지(타입, 보정 전, 보정 후)를 입력해 주십시오. 3. **[추가]** 버튼을 클릭해 주십시오. ### 메시지 수정 등록된 메시지를 수정하는 방법은 다음과 같습니다. 1. 도메인의 빌더에서 **인식 결과 보정** 메뉴를 클릭해 주십시오. 2. 메시지 목록에서 수정할 메시지의 ![i-clovaspeech-edit](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-edit.png?sv=2026-02-06&spr=https&st=2026-10-29T10%3A50%3A00Z&se=2026-10-29T11%3A50%3A00Z&sr=c&sp=r&sig=FGRtWtzRluu6UcJc3JOQ70QmlzH6448dx7%2BuvPWdro8%3D)을 클릭해 주십시오. 3. 메시지 입력란을 클릭하여 메시지를 수정한 후 ![i-clovaspeech-keywordeditcheck](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-keywordeditcheck.png?sv=2026-02-06&spr=https&st=2026-10-29T10%3A50%3A00Z&se=2026-10-29T11%3A50%3A00Z&sr=c&sp=r&sig=FGRtWtzRluu6UcJc3JOQ70QmlzH6448dx7%2BuvPWdro8%3D)을 클릭해 주십시오. - 메시지 수정을 취소하려면 ![i-clovaspeech-keywordeditcancel](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-keywordeditcancel.png?sv=2026-02-06&spr=https&st=2026-10-29T10%3A50%3A00Z&se=2026-10-29T11%3A50%3A00Z&sr=c&sp=r&sig=FGRtWtzRluu6UcJc3JOQ70QmlzH6448dx7%2BuvPWdro8%3D)을 클릭해 주십시오. ### 메시지 다운로드 등록한 메시지를 일괄 다운로드하는 방법은 다음과 같습니다. 1. 도메인의 빌더에서 **인식 결과 보정** 메뉴를 클릭해 주십시오. 2. 메시지 목록에서 다운로드할 메시지의 체크 박스를 클릭하여 선택해 주십시오. - 여러 메시지를 동시에 선택할 수 있습니다. 3. **[다운로드]** 버튼을 클릭해 주십시오. - 선택된 메시지가 포함된 엑셀 파일이 다운로드됩니다. ### 메시지 삭제 등록한 메시지를 삭제하는 방법은 다음과 같습니다. 1. 도메인의 빌더에서 **인식 결과 보정** 메뉴를 클릭해 주십시오. 2. 메시지 목록에서 삭제할 메시지의 체크 박스를 클릭하여 선택해 주십시오. - 여러 메시지를 동시에 선택할 수 있습니다. - 메시지의 **[삭제]** 버튼을 클릭하여 바로 메시지를 삭제할 수도 있습니다. 3. **[메시지 삭제]** 버튼을 클릭해 주십시오. ## API 호출 정보 및 도메인 정보 확인 **설정** 메뉴에서는 API 호출을 위한 연동 정보와 빌더에 연결된 도메인의 정보를 확인할 수 있습니다. ### API 호출 정보 확인 API 호출을 위한 연동 정보를 확인하는 방법은 다음과 같습니다. 참고 API를 호출하여 인식 대상 파일을 전송하고 인식 결과를 받을 수 있습니다. API 호출 방법은 [CLOVA Speech API 가이드](https://api.ncloud-docs.com/docs/ai-application-service-clovaspeech)를 참고해 주십시오. 1. 도메인의 빌더에서 **설정** 메뉴를 클릭해 주십시오. 2. **[연동 정보]** 탭을 클릭해 주십시오. 3. 도메인의 **Secret Key**와 **CLOVA Speech Invoke URL**을 확인해 주십시오. - **[생성]** 버튼: 클릭하여 Secret Key 생성/재생성 - **[복사]** 버튼: 클릭하여 해당 정보를 클립보드에 복사 ### 도메인 정보 확인 빌더에 연결된 도메인의 정보를 확인하는 방법은 다음과 같습니다. 1. 도메인의 빌더에서 **설정** 메뉴를 클릭해 주십시오. 2. **[도메인 정보]** 탭을 클릭해 주십시오. 3. 빌더에 연결된 도메인 정보를 확인해 주십시오. - **도메인 정보** - **도메인 이름**: 도메인의 이름 - **도메인 코드**: 도메인의 코드 - **유형**: 도메인에 적용된 요금제 플랜 - **Storage 설정** - **결과 파일 저장 경로**: 인식 결과 파일을 저장하는 Object Storage 경로 - **인식 대상 저장 경로**: 인식 대상 파일을 선택하는 Object Storage 경로 - **[Object Storage 바로가기]** 버튼: 클릭하여 Object Storage의 콘솔 화면으로 이동