---
title: "장문 인식 빌더"
slug: "clovaspeech-builder-long"
tags: ["빌더", "CLOVA Speech"]
updated: 2026-07-23T09:02:21Z
published: 2026-07-23T09:02:21Z
canonical: "guide-fin.ncloud-docs.com/clovaspeech-builder-long"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 장문 인식 빌더
CLOVA Speech의 빌더를 사용하면 UI 환경으로 음성 인식 작업을 요청하고 관리할 수 있습니다. 빌더는 도메인별로 제공되며, 빌더에서는 다음과 같은 메뉴를 사용할 수 있습니다.
* **작업목록** 메뉴: 인식 작업 등록 및 관리, 작업 결과 편집 및 내보내기
* **키워드 부스팅** 메뉴: 인식 확률을 높이고 싶은 단어를 키워드로 등록 및 등록한 키워드 관리
* **설정** 메뉴: 도메인의 정보 확인
:::(Info) (참고)
도메인 유형에 따라 일부 기능은 노출되지 않을 수 있습니다.
:::
## 빌더 실행
빌더를 실행하는 방법은 다음과 같습니다.
:::(Info) (참고)
빌더를 사용하기 위해서는 먼저 도메인을 생성해야 합니다. 도메인 생성에 대한 자세한 내용은 [도메인 생성](/docs/clovaspeech-domain#도메인생성)을 참고해 주십시오.
:::
1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI Services** > **CLOVA Speech** 메뉴를 차례대로 클릭해 주십시오.
2. **장문인식** 유형의 **Domain** 메뉴를 클릭해 주십시오.
3. 빌더를 실행할 도메인의 **[빌더 실행]** 버튼을 클릭해 주십시오.
## 인식 작업 요청 및 관리
빌더의 **작업목록** 메뉴에서 인식 작업을 요청하고 각 작업의 진행 상황을 확인할 수 있습니다. 또한, 인식 결과 수정 에디터를 사용하여 인식 결과를 편집하고 원하는 형식으로 내보낼 수 있습니다.
### 작업목록 화면
빌더 이용을 위한 **작업목록** 메뉴의 기본적인 설명은 다음과 같습니다.
{height="" width="70%"}
| 영역 | 설명 |
| :--- | :--- |
| ① 메뉴명 | 현재 확인 중인 메뉴명 |
| ② 작업 관리 기능 | 인식 작업 요청, 삭제, 내보내기, 재인식 |
| ③ 검색창 | 작업 대상 파일 이름 또는 결과 파일 위치로 작업 검색 |
| ④ 작업 목록 | 조회 중인 인식 작업 목록 |
### 인식 작업 목록 확인
빌더에서 등록한 인식 작업의 정보를 확인하는 방법은 다음과 같습니다.
1. 도메인의 빌더에서 **작업목록** 메뉴를 클릭해 주십시오.
2. 작업 목록이 나타나면 인식 작업의 정보를 확인해 주십시오.
* **작업 대상**: 인식 작업 대상 미디어 파일 이름
* **언어**: 인식 작업에 사용하는 언어
* **작업 현황**: 작업의 현재 상태로, 다음 중 하나로 표시
| 작업 현황 | 설명 |
| :--- | :--- |
| **작업 대기** | 인식 작업을 대기 중인 상태- 서버가 모두 작업 중인 경우이며, 서버 가용 시점에 **작업 중**으로 변경
- **[인식작업취소]** 버튼: 클릭하여 작업 취소
|
| **작업 중** | 인식 작업이 진행 중인 상태 |
| **취소 완료** | 인식 작업 취소가 완료된 상태 |
| **취소 중** | 인식 작업을 취소 중인 상태 |
| **작업 실패** | 인식 작업에 실패한 상태- : 클릭하여 작업 실패 사유 확인
|
| **작업 완료** | 인식 작업이 완료된 상태 |
* **요청 방법**: 작업 파일 업로드 방식
* **Object Storage에서 선택**인 경우, 을 클릭하여 Object Storage 콘솔 화면으로 이동 가능
* **결과 파일 위치**: 결과 파일을 저장하는 Object Storage의 경로
* 을 클릭하여 Object Storage 콘솔 화면으로 이동 가능
* **작업 시작일(UTC+09:00)**: 작업을 시작한 일시
* **작업 종료일(UTC+09:00)**: 작업을 종료한 일시
* **인식 결과 편집**: **[인식 결과 편집]** 버튼을 클릭하여 인식 결과 수정 에디터 실행([인식 결과 수정 에디터 사용](#인식결과수정에디터사용) 참고)
### 인식 작업 요청
빌더에서 인식 작업을 요청하는 방법은 다음과 같습니다.
1. 도메인의 빌더에서 **작업목록** 메뉴를 클릭해 주십시오.
2. **[인식 작업 요청]** 버튼을 클릭해 주십시오.
3. 인식 대상 파일을 업로드할 방법에 알맞은 탭을 클릭해 주십시오.
* **[Object Storage에서 선택]** 탭: 도메인의 인식 대상 저장 경로 및 하위 경로에서 파일 선택
* **[파일 업로드]** 탭: 로컬 PC에 있는 파일 선택
4. 작업 정보를 입력해 주십시오.
* **결과 파일 위치**: 결과 파일을 저장할 Object Storage의 경로 선택
* 도메인의 결과 파일 저장 경로 및 하위 경로 선택 가능
* **언어 설정**: 인식 작업에 사용할 언어 선택
* **화자분리 기능 사용**: 화자 분리 기능 사용 여부 선택
* **키워드 부스팅**: 키워드 부스팅 사용 여부 선택(키워드 부스팅에 대한 자세한 내용은 [키워드 부스팅](#키워드부스팅) 참고)
5. 인식 대상 파일을 업로드해 주십시오.
* **[Object Storage에서 선택]** 탭을 선택한 경우: **대상 파일 선택** 영역에서 파일 선택
* 폴더를 더블 클릭하여 폴더 내 파일을 확인할 수 있습니다.
* **[파일 업로드]** 탭을 선택한 경우: **마우스로 파일을 끌고 오거나 여기를 클릭하세요.** 영역에 파일을 끌어넣거나, 마우스로 파일을 끌고 오거나 여기를 클릭하세요.를 클릭한 후 파일 선택
6. **[요청시작]** 버튼을 클릭해 주십시오.
* 작업이 완료되면 **결과 파일 위치**의 경로에서 인식 결과 파일(JSON) 확인 가능
:::(Info) (참고)
하나의 음원에서 인식할 수 있는 최대 화자의 수는 10명입니다. 재인식 기능 사용 시 동일한 음원에 대해 인식 작업 요청을 다시 하지 않아도 됩니다.
:::
### 인식 결과 수정 에디터 사용
인식 작업이 완료되면 인식 결과 수정 에디터를 실행하여 인식 대상 미디어 파일과 인식된 텍스트를 함께 확인할 수 있습니다. 또한, 인식 결과를 편집하고 원하는 형식으로 내보낼 수 있습니다.
#### 인식결과 편집 화면
인식 결과 수정 에디터를 실행하면 인식결과 편집 화면이 나타납니다. 인식결과 편집 화면의 기본적인 설명은 다음과 같습니다.
{height="" width="70%"}
| 영역 | 설명 |
| :--- | :--- |
| ① **내보내기** | 편집한 결과 내보내기 |
| ② 인식 대상 파일 | - 인식 대상 파일을 재생/정지
- 인식 대상 파일 및 인식된 텍스트 정보 표시
|
| ③ 필터 | 화자 및 신뢰도를 기준으로 인식 결과 필터링 |
| ④ 인식 결과 | - 인식된 텍스트를 타임라인 형태로 표시
- 인식된 화자 및 텍스트 수정 가능
|
| ⑤ 재생 기능 | 인식 대상 파일의 재생 및 음량 조절 |
#### 인식 결과 편집 및 내보내기
인식 결과 수정 에디터에서 인식 결과를 편집하고 원하는 형식으로 내보내는 방법은 다음과 같습니다.
:::(Info) (참고)
[인식 결과 내보내기](#인식결과내보내기)를 통해 한 번에 여러 작업의 결과 파일을 내보낼 수도 있습니다.
:::
1. 도메인의 빌더에서 **작업목록** 메뉴를 클릭해 주십시오.
2. 작업 목록에서 완료된 작업의 **[인식 결과 편집]** 버튼을 클릭해 주십시오.
3. 인식결과 편집 화면에서 인식 결과를 확인해 주십시오.
* 미디어 파일 재생 시, 타임라인에서 현재 재생 중인 음성에 해당하는 텍스트 강조 표시
* **[화자명]** 버튼: 클릭하여 화자를 기준으로 인식된 텍스트 필터링
* **[인식 결과 신뢰도]** 버튼: 클릭하여 인식 결과 신뢰도를 기준으로 인식된 텍스트 필터링
4. 필요한 경우, 인식 결과를 편집해 주십시오.
* 화자 편집: 드롭다운 메뉴를 클릭한 후 해당 텍스트의 화자 편집
* : 클릭하여 화자 삭제
* : 클릭하여 화자의 이름 수정
* **[화자 추가]** 버튼: 클릭하여 화자 추가
* 텍스트 편집: 으로 표시된 행을 클릭하여 내용을 편집한 후 을 클릭
* 편집을 취소하려면 을 클릭해 주십시오.
* 편집한 내용은 초록색으로 강조 표시됩니다.
5. 인식 결과를 내보내려면 **[내보내기]** 버튼을 클릭한 후 설정 정보를 입력하고 **[확인]** 버튼을 클릭해 주십시오.
* **파일 이름**: 내보낼 결과 파일의 이름 입력
* **파일 형식**: 드롭다운 메뉴를 클릭하여 내보낼 파일 형식 선택(**json**, **smi**, **srt**, **txt**, **csv**, **xls** 중 선택)
* **타임 라인 뒤로 밀기**: 설정한 시간만큼 인식 결과의 타임라인 시간을 뒤로 밀기
* **내보내기 방법**: **Object Storage** 또는 **다운로드** 중 선택
* **Object Storage**를 선택한 경우, **파일 위치**를 클릭하여 인식 결과 파일을 저장할 경로 선택
* **다운로드**를 선택한 경우, 로컬 PC에 인식 결과 파일 다운로드
### 인식 결과 내보내기
여러 작업의 인식 결과 파일을 내보내는 방법은 다음과 같습니다.
:::(Info) (참고)
**작업 현황**이 **작업 완료**인 작업의 인식 결과 파일만 내보낼 수 있습니다.
:::
1. 도메인의 빌더에서 **작업목록** 메뉴를 클릭해 주십시오.
2. 내보낼 작업을 클릭하여 선택해 주십시오.
* 여러 작업을 동시에 선택할 수 있습니다.
3. **[내보내기]** 버튼을 클릭해 주십시오.
4. 내보내기 팝업 창이 나타나면 내보내기 설정을 확인하고 **[확인]** 버튼을 클릭해 주십시오.
* : 클릭하여 인식 결과 파일의 이름 수정
* : 클릭하여 내보내기 목록에서 삭제
* **파일 형식**: 드롭다운 메뉴를 클릭하여 내보낼 파일 형식 선택(**json**, **smi**, **srt**, **txt**, **csv**, **xls** 중 선택)
* **내보내기 방법**: **Object Storage** 또는 **다운로드** 중 선택
* **Object Storage**를 선택한 경우, **결과 파일 위치**를 클릭하여 인식 결과 파일을 저장할 경로 선택
* **다운로드**를 선택한 경우, 로컬 PC에 인식 결과 파일 다운로드
### 인식 작업 삭제
등록한 인식 작업을 삭제하는 방법은 다음과 같습니다.
1. 도메인의 빌더에서 **작업목록** 메뉴를 클릭해 주십시오.
2. 삭제할 작업을 클릭하여 선택해 주십시오.
* 여러 작업을 동시에 선택할 수 있습니다.
3. **[삭제]** 버튼을 클릭해 주십시오.
4. 작업 삭제 팝업 창이 나타나면 **[삭제]** 버튼을 클릭해 주십시오.
## 키워드 부스팅
키워드 부스팅을 통해 특정 단어에 대한 인식율을 높일 수 있습니다. **키워드 부스팅** 메뉴에서는 키워드를 등록하고 관리할 수 있습니다.
### 키워드 부스팅 화면
빌더 이용을 위한 **키워드 부스팅** 메뉴의 기본적인 설명은 다음과 같습니다.
{height="" width="70%"}
| 영역 | 설명 |
| :--- | :--- |
| ① 메뉴명 | 현재 확인 중인 메뉴명 |
| ② 키워드 관리 기능 | 키워드 파일 업로드, 등록한 키워드 다운로드 및 삭제 |
| ③ 검색창 | 키워드 검색 |
| ④ 키워드 목록 | 조회 중인 키워드 목록 |
### 키워드 추가
인식율을 높일 키워드를 추가하는 방법은 다음과 같습니다.
:::(Info) (참고)
* 최대 1,000 단어를 추가할 수 있으며, 한국어와 영어를 지원합니다.
* 키워드는 500 단어 이하로 등록할 것을 권장하며, 500 단어 초과 시 성능 저하가 있을 수 있습니다.
* 가중치가 높을수록 유사한 단어를 더 많이 인식하므로, 인식 결과에 영향을 미칠 수 있습니다.
:::
다음 중 원하는 방식으로 키워드를 추가할 수 있습니다.
* [키워드 파일 업로드](#키워드파일업로드): 키워드를 입력한 엑셀 파일을 업로드하여 여러 개의 키워드 일괄 추가
* [키워드 개별 추가](#키워드개별추가): 빌더에서 키워드를 입력하여 추가
#### 키워드 파일 업로드
키워드를 입력한 엑셀 파일을 업로드하여 여러 개의 키워드를 일괄 등록하는 방법은 다음과 같습니다.
1. 키워드와 가중치를 입력한 엑셀 파일을 작성해 주십시오.
* 가중치는 1~5의 정수로 입력해 주십시오.
* 4번 절차의 화면에서 **업로드 템플릿**을 클릭하면 키워드 파일의 템플릿을 확인할 수 있습니다.
2. 도메인의 빌더에서 **키워드 부스팅** 메뉴를 클릭해 주십시오.
3. **[업로드]** 버튼을 클릭해 주십시오.
4. 업로드 팝업 창이 나타나면 **마우스로 파일을 끌고 오거나 여기를 클릭하세요.** 영역에 로컬 PC에 있는 키워드 파일을 끌어넣거나 **마우스로 파일을 끌고 오거나 여기를 클릭하세요.** 영역을 클릭한 후 키워드 파일을 선택해 주십시오.
5. **[확인]** 버튼을 클릭해 주십시오.
* 덮어씌우기: 체크 박스를 클릭해 선택하면 기존의 모든 키워드를 삭제하고 새로 키워드 등록
:::(Info) (참고)
키워드 파일에 기존의 키워드와 중복되는 키워드가 포함된 경우, 키워드 등록에 실패합니다. 중복된 키워드를 삭제하거나, 파일 업로드 시 덮어씌우기 체크 박스를 클릭해 주십시오.
:::
#### 키워드 개별 추가
빌더에서 키워드를 직접 추가하는 방법은 다음과 같습니다.
1. 도메인의 빌더에서 **키워드 부스팅** 메뉴를 클릭해 주십시오.
2. **추가할 키워드를 입력해주세요.** 영역을 클릭하여 키워드를 입력해 주십시오.
3. **가중치** 드롭다운 메뉴에서 가중치 값을 선택해 주십시오.
4. **[추가]** 버튼을 클릭해 주십시오.
### 키워드 수정
등록한 키워드를 수정하는 방법은 다음과 같습니다.
1. 도메인의 빌더에서 **키워드 부스팅** 메뉴를 클릭해 주십시오.
2. 키워드 목록에서 수정할 키워드의 을 클릭해 주십시오.
3. 키워드 입력란을 클릭하여 키워드를 수정한 후 을 클릭해 주십시오.
* 키워드 수정을 취소하려면 을 클릭해 주십시오.
* 가중치를 수정하려면 **가중치** 드롭다운 메뉴에서 가중치 값을 선택해 주십시오.
### 키워드 다운로드
등록한 키워드를 일괄 다운로드하는 방법은 다음과 같습니다.
1. 도메인의 빌더에서 **키워드 부스팅** 메뉴를 클릭해 주십시오.
2. 키워드 목록에서 다운로드할 키워드의 체크 박스를 클릭하여 선택해 주십시오.
* 여러 키워드를 동시에 선택할 수 있습니다.
3. **[다운로드]** 버튼을 클릭해 주십시오.
* 키워드와 가중치 정보를 포함한 엑셀 파일이 다운로드됩니다.
### 키워드 삭제
등록한 키워드를 삭제하는 방법은 다음과 같습니다.
1. 도메인의 빌더에서 **키워드 부스팅** 메뉴를 클릭해 주십시오.
2. 키워드 목록에서 삭제할 키워드의 체크 박스를 클릭하여 선택해 주십시오.
* 여러 키워드를 동시에 선택할 수 있습니다.
* 키워드의 **[삭제]** 버튼을 클릭하여 바로 키워드를 삭제할 수도 있습니다.
3. **[키워드 삭제]** 버튼을 클릭해 주십시오.
4. 알림 팝업 창이 나타나면 **[확인]** 버튼을 클릭해 주십시오.
## API 호출 정보 및 도메인 정보 확인
**설정** 메뉴에서는 API 호출을 위한 연동 정보와 빌더에 연결된 도메인의 정보를 확인할 수 있습니다.
### API 호출 정보 확인
API 호출을 위한 연동 정보를 확인하는 방법은 다음과 같습니다.
:::(Info) (참고)
API를 호출하여 인식 대상 파일을 전송하고 인식 결과를 받을 수 있습니다. API 호출 방법은 [CLOVA Speech API 가이드](https://api-fin.ncloud-docs.com/docs/ai-application-service-clovaspeech){target="_blank"}를 참고해 주십시오.
:::
1. 도메인의 빌더에서 **설정** 메뉴를 클릭해 주십시오.
2. **[연동 정보]** 탭을 클릭해 주십시오.
3. 도메인의 **Secret Key**와 **CLOVA Speech Invoke URL**을 확인해 주십시오.
* **[생성]** 버튼: 클릭하여 Secret Key 생성/재생성
* **[복사]** 버튼: 클릭하여 해당 정보를 클립보드에 복사
### 도메인 정보 확인
빌더에 연결된 도메인의 정보를 확인하는 방법은 다음과 같습니다.
1. 도메인의 빌더에서 **설정** 메뉴를 클릭해 주십시오.
2. **[도메인 정보]** 탭을 클릭해 주십시오.
3. 빌더에 연결된 도메인 정보를 확인해 주십시오.
* **도메인 정보**
* **도메인 이름**: 도메인의 이름
* **도메인 코드**: 도메인의 코드
* **유형**: 도메인에 적용된 요금제 플랜
* **Storage 설정**
* **결과 파일 저장 경로**: 인식 결과 파일을 저장하는 Object Storage 경로
* **인식 대상 저장 경로**: 인식 대상 파일을 선택하는 Object Storage 경로
* **[Object Storage 바로가기]** 버튼: 클릭하여 Object Storage의 콘솔 화면으로 이동