---
title: "Long-form recognition builder"
slug: "clovaspeech-builder-long"
tags: ["CLOVA Speech"]
updated: 2026-10-08T07:12:00Z
published: 2026-10-08T07:12:00Z
canonical: "guide.ncloud-docs.com/clovaspeech-builder-long"
---

> ## 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.

# Long-form recognition builder

Available in Classic and VPC

Using the CLOVA Speech Builder, you can submit and manage voice recognition tasks through a UI environment. Builders are provided per domain, and you can use the following menus within the Builder:

- **Task list**: Register and manage recognition tasks, and edit and export task results.
- **Keyword boosting**: Register words whose recognition probability you want to increase as keywords and manage registered keywords.
- **Settings**: Check domain information.

              Note

              

Some features may not be displayed depending on the domain type.

## Launch Builder

To run the Builder:

              Note

              

You must create a domain before using the Builder. For more information, see [Create domain](/docs/en/clovaspeech-domain#%EB%8F%84%EB%A9%94%EC%9D%B8%EC%83%9D%EC%84%B1).

1. In the NAVER Cloud Platform console, navigate to **Menu** > **All Services** > **AI Services** > **CLOVA Speech**.
2. Click the **Domain** menu for the **long-form recognition** type.
3. Click **[Run Builder]** for the domain you want to use.

## Request and manage recognition tasks

From the **Task list** menu in the Builder, you can submit recognition tasks and monitor their progress. You can also edit recognition results using the result editor and export them in the desired format.

### Task list interface

The **Task list** menu includes the following components: ![clovaspeech-builder_list2_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/clovaspeech-builder_list2_en.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D)

| Component | Description |
| --- | --- |
| ① Menu name | Current menu name. |
| ② Task management features | Submit, delete, export, and re-recognize tasks. |
| ③ Search bar | Search tasks by media file name or result file location. |
| ④ Task list | Show recognition task list currently being viewed. |

### Check recognition task list

To view details about recognition tasks registered in the Builder:

1. In the domain's builder, click the **Task list** menu.
2. When the task list appears, review the recognition task details.
  - **Task target**: Name of the recognition task target media file.
  - **Language**: Choose the language to use for the recognition task.
  - **Task status**: The current status of the task, indicated as one of the following.

| Task status | Description |
| --- | --- |
| **Waiting** | Recognition task "Waiting" status. - Occurs when all servers are in task status. - Changes to **Task in progress** once a server becomes available. - **[Cancel Recognition Task]**: Cancel task. |
| **Task in progress** | Recognition task in progress status. |
| **Canceled** | Task has been successfully canceled. |
| **Canceling** | Task is being canceled. |
| **Task failed** | Task failed. - ![i-clovaspeech-more](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-more.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D) Click to view the reason for failure. |
| **Task completed** | Task is complete. |
  - **Request method**: How to upload a task file.
    - If the file was **selected from Object Storage**, click ![i-clovaspeech-window](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-window.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D) to open the Object Storage console.
  - **Result file location**: Object Storage path where result files are saved.
    - Click ![i-clovaspeech-window](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-window.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D) to open the Object Storage console.
  - **Start date (UTC+09:00)**: Date and time when the task started.
  - **End date (UTC+09:00)**: Date and time when the task ended.
  - **Edit recognition results**: Click the **[Edit recognition result]** button to run the recognition result editor (see [Using the recognition result editor](/docs/en/clovaspeech-builder-long#%EC%9D%B8%EC%8B%9D%EA%B2%B0%EA%B3%BC%EC%88%98%EC%A0%95%EC%97%90%EB%94%94%ED%84%B0%EC%82%AC%EC%9A%A9)).

### Request recognition task

To submit a recognition task in the Builder:

1. In the domain's builder, click the **Task list** menu.
2. Click **[Submit recognition task]**.
3. Select the tab for how you want to upload the input file.
  - **[Select from Object Storage]**: Select a file from the domain's recognition target storage path and sub-path.
  - **[Upload File]**: Select a file in the local PC.
4. Enter the task details.
  - **Result file location**: Select the Object Storage path to save the result file
    - You can select the domain's predefined result path and its subdirectories.
  - **Language settings**: Select the language to use for the recognition task.
  - **Use speaker separation feature**: Select whether to use the speaker separation feature.
  - **Detect event**: Select whether to enable detection of events (applause, laughter, music) in the sound source.
  - **Keyword boosting**: Select whether or not to use keyword boosting (for more information about keyword boosting, see [Keyword boosting](/docs/en/clovaspeech-builder-long#%ED%82%A4%EC%9B%8C%EB%93%9C%EB%B6%80%EC%8A%A4%ED%8C%85)).
5. Upload the input file.
  - If you selected **[Select from Object Storage]**: Select a file from the **Select target file** area.
    - Double-click a folder to view its contents.
  - If you selected **[Upload file]**: **Drag the file with your mouse or click here.** Drag and drop a file into the area, or click on the area and select a file.
6. Click **[Start request]**.
  - When the task is complete, you can view the result JSON file in the **result file path**.

              Note

              

A maximum of 30 speakers can be recognized in a single audio file. When using the re-recognition feature, you do not need to submit the recognition task again for the same audio file.

### Using recognition result editor

After a recognition task is completed, you can open the result editor to view the media file and recognized text together. You can also edit the recognition results and export them in the desired format.

#### Recognition result editing interface

Running the result editor opens the result editing interface. The following is an overview of the recognition result editing interface: ![clovaspeech-long-demo_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/clovaspeech-long-demo_en.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D)

| Component | Description |
| --- | --- |
| ① **Export** | Exports the edited results. |
| ② Input file | - Playback or pause the input file. - Displays the input file and recognized text information. |
| ③ Filter | Filters recognition results by speaker or confidence based on the filtering criteria. |
| ④ Voice recognition results | - Displays recognized text in a timeline format. - Allows editing of detected speakers and text. |
| ⑤ Event detection results | - Displays detected events (clapping, laughter, music) in a timeline format. - Allows editing of detected events. |
| ⑥ Playback feature | Playback of the input file and volume control. |

#### Edit and export recognition results

To edit recognition results and export them in the desired format using the result editor:

              Note

              

You can export multiple task results all at once using [Export recognition results](/docs/en/clovaspeech-builder-long#%EC%9D%B8%EC%8B%9D%EA%B2%B0%EA%B3%BC%EB%82%B4%EB%B3%B4%EB%82%B4%EA%B8%B0).

1. In the domain's builder, click the **Task list** menu.
2. Click **[Edit recognition result]** for a completed task in the task list.
3. In the result editing interface, review the recognition results.
  - When playing the media file, the text corresponding to the voice currently in playback is highlighted in the timeline.
  - **[Speaker name]**: Click it to filter recognized texts by speaker.
  - **[Recognition result reliability]**: Click it to filter recognized texts by reliability of recognition results.
4. Edit the recognition results if needed.
  - Edit speaker: Click the drop-down menu to edit the speaker of the text.
    - ![i-clovaspeech-speakerdelete](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-speakerdelete.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D): Delete a speaker.
    - ![i-clovaspeech-speakeredit](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-speakeredit.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D): Edit a speaker's name.
    - **[Add speaker]**: Click it to add a speaker.
  - Edit text: Click the row marked as ![i-clovaspeech-resultedit](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-resultedit.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D) to edit the contents, and click ![i-clovaspeech-resultedit2](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-resultedit2.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D).
    - To cancel edits, click ![i-clovaspeech-editcancel](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-editcancel.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D).
    - Edited content is highlighted in green.
5. To export recognition results, click **[Export]**, enter settings information, and click **[OK]**.
  - **File name**: Enter the name of the result file to export.
  - **File format**: Select the file format you want to export the file as from the drop-down menu (select from `json`, `smi`, `srt`, `txt`, `csv`, and `xls`).
  - **Push back timeline**: Push back the timeline of recognition results by the set time.
  - **Export method**: Select **Object Storage** or **Download**.
    - For **Object Storage**, click the **file path** to select the save location.
    - For **Download**, select the local PC to download the recognition result file.

### Export recognition results

To export the result files of multiple tasks all at once:

              Note

              

Only tasks with the **Task status** set to **Completed** can be exported.

1. In the domain's builder, click the **Task list** menu.
2. Select the task you want to export.
  - Multiple tasks can be selected all at once.
3. Click **[Export]**.
4. When the **Export** popup appears, check the export settings and click **[OK]**.
  - ![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-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D): Click to edit the result file name.
  - ![i-clovaspeech-delete](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovaspeech-delete.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D): Click to delete a task from the export list.
  - **File format**: Select the file format you want to export the file as from the drop-down menu (select from `json`, `smi`, `srt`, `txt`, `csv`, and `xls`).
  - **Export method**: Select **Object Storage** or **Download**.
    - For **Object Storage**, click the **result file path** to select the save location.
    - For **Download**, select the local PC to download the recognition result file.

### Delete recognition task

To delete registered recognition tasks:

1. In the domain's builder, click the **Task list** menu.
2. Select the task you want to delete.
  - Multiple tasks can be selected all at once.
3. Click **[Delete]**.
4. When the **Delete task** popup appears, click **[Delete]**.

## Keyword boosting

You can increase the recognition rate for a specific word through keyword boosting. In the **Keyword boosting** menu, you can register and manage keywords.

### Keyword boosting interface

The **Keyword boosting** menu includes the following components: ![clovaspeech-builder_keyword_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/clovaspeech-builder_keyword_en.png?sv=2026-02-06&spr=https&st=2026-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D)

| Component | Description |
| --- | --- |
| ① Menu name | Current menu name. |
| ② Keyword management features | Upload keyword files, download and delete registered keywords. |
| ③ Search bar | Search keywords. |
| ④ Keyword list | List of keywords being viewed. |

### Add keywords

To add keywords you want to boost:

              Note

              

- You can add up to 1,000 words, and Korean and English are supported.
- It is recommended to register no more than 500 words. Registering more than 500 words may degrade performance.
- Higher weight values increase recognition of similar words, which may affect accuracy.

You can add keywords using either method below:

- [Upload keyword files](/docs/en/clovaspeech-builder-long#%ED%82%A4%EC%9B%8C%EB%93%9C%ED%8C%8C%EC%9D%BC%EC%97%85%EB%A1%9C%EB%93%9C): Enter multiple keywords all at once by uploading an Excel file containing keywords.
- [Add individual keywords](/docs/en/clovaspeech-builder-long#%ED%82%A4%EC%9B%8C%EB%93%9C%EA%B0%9C%EB%B3%84%EC%B6%94%EA%B0%80): Enter keywords in the builder and add them.

#### Upload keyword file

To enter keywords in an Excel file and register multiple keywords all at once:

1. Prepare an Excel file and enter keywords and weight values.
  - Enter weights as integers between 1 and 5.
  - In step 4, click **Upload template** on the interface to view the keyword file template.
2. In the domain's Builder, click the **Keyword boosting** menu.
3. Click **[Upload]**.
4. When the **Upload** popup appears, **drag a file into the window or click here**. Drag and drop the keyword file into the area, or click on the area to select the keyword file.
5. Click **[OK]**.
  - Overwrite: If you click the checkbox to select it, all existing keywords are deleted and new keywords are registered.

              Note

              

If the file contains keywords that have already been registered, the upload will fail. Remove duplicate keywords or enable overwrite when uploading.

#### Add individual keywords

To add keywords directly in the Builder:

1. In the domain's Builder, click the **Keyword boosting** menu.
2. **Enter the keyword you want to add.** Click the area and enter keywords.
3. Select a **weight** value from the dropdown menu.
4. Click **[Add]**.

### Edit keywords

To edit a registered keyword:

1. In the domain's Builder, click the **Keyword boosting** menu.
2. In the keyword list, click ![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-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D) for the keyword you want to edit.
3. Click the keyword input field, edit the keyword, and then click ![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-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D).
  - To cancel editing, click ![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-11-14T04%3A50%3A30Z&se=2026-11-14T05%3A50%3A30Z&sr=c&sp=r&sig=vZh0uJQq791VQhrOsJ4i8UIDL5gVx5ku0j%2Bia%2BVEvmQ%3D).
  - To edit the **weight**, select a new value from the dropdown menu.

### Download keywords

To download registered keywords:

1. In the domain's Builder, click the **Keyword boosting** menu.
2. In the keyword list, select the checkboxes for the keywords you want to download.
  - Multiple keywords can be selected all at once.
3. Click **[Download]**.
  - An Excel file containing the keywords and weight information will be downloaded.

### Delete keywords

To delete registered keywords:

1. In the domain's Builder, click the **Keyword boosting** menu.
2. In the keyword list, select the checkboxes for the keywords you want to delete.
  - Multiple keywords can be selected all at once.
  - You may also click the **[Delete]** button of the keyword to immediately delete the keyword.
3. Click **[Delete keywords]**.
4. When the **Notification** popup appears, click **[OK]**.

## Check API call information and domain information

In the **Settings** menu, you can check the integrate information required for API calls and the information of the domain connected to the Builder.

### Check API call information

To check the integrate information required for API calls:

              Note

              

You can call the API to transfer audio files for recognition and receive recognition results. For more information about calling the API, see [CLOVA Speech API guide](https://api.ncloud-docs.com/docs/en/ai-application-service-clovaspeech).

1. In the domain's Builder, click the **Settings** menu.
2. Click the **[Integrate information]** tab menu.
3. Check the domain's **Secret Key** and **CLOVA Speech Invoke URL**.
  - **[Create]**: Click it to create/re-create the secret key
  - **[Copy]**: Click it to copy the information to the clipboard

### Check domain information

To check the information of the domain connected to the Builder:

1. In the domain's Builder, click the **Settings** menu.
2. Click the **[Domain information]** tab menu.
3. Check the domain information connected to the Builder.
  - **Domain information**
    - **Domain name**: The name of the domain.
    - **Domain code**: The code of the domain.
    - **Type**: The pricing plan applied to the domain.
  - **Storage settings**
    - **Result file storage path**: Object Storage path for storing recognition result files.
    - **Recognition target storage path**: Object Storage path for selecting recognition target files.
    - **[Go to Object Storage]**: Click it to go to the Object Storage console.