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 menu: Register and manage recognition tasks, edit results, and export output.
• Keyword boosting menu: Register keywords for words you want to boost in recognition probability, and manage registered keywords.
• Settings menu: View domain information.

Launch the Builder

To run the Builder:

1. In the NAVER Cloud Platform console, navigate to Menu > Services > AI Services > CLOVA Speech.
2. Click the Domain menu for the long-form recognition type.
3. Click [Launch 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:

View 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.
   • Target file: Name of the media file used for recognition.
   • Language: Language used for the recognition task.
   • Task status: Current status of the task, displayed as one of the following:

     Task status	Description
     Waiting	Recognition task "Waiting" status Occurs when all servers are occupied. Changes to In progress once a server becomes available. [Cancel recognition task]: Cancels the task.
     In progress	Task is currently being processed.
     Canceled	Task has been successfully canceled.
     Canceling	Task is being canceled.
     Failed	Task failed. : Click to view the reason.
     Completed	Task is complete.

   • Request method: How the input file was uploaded
     • If the file was selected from Object Storage, click to open the Object Storage console interface.
   • Result file location: Object Storage path where the result file is saved.
     • Click to open the Object Storage console interface.
   • 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 result: Click [Edit recognition result] to open the result editor (see Use the result editor).

Submit a 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 tab: Select a file from the domain's input file path or its subdirectories.
   • [File upload] tab: Select a file from your local PC.
4. Enter the task details.
   • Result file location: Select the Object Storage path where the result file will be saved.
     • You can select the domain's predefined result path and its subdirectories.
   • Language settings: Select the language for recognition.
   • Speaker separation: Select whether to use speaker separation.
   • Event detection: Select whether to detect events such as clapping, laughter, or music.
   • Keyword boosting: Select whether to use keyword boosting (for details, see Keyword boosting).
5. Upload the input file.
   • When using Select from [Object Storage]: Select a file in the file selection area.
     • Double-click a folder to view its contents.
   • When using File upload tab: Drag and drop a file 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.

Use the 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.

Result editing interface

Running the result editor opens the result editing interface. Here is an overview of its components:

Edit and export recognition results

You can edit recognition results and export them in the desired format using the result editor.

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 corresponding text in the timeline is highlighted.
   • [Speaker]: Filter recognized text by speaker.
   • [Confidence in recognition results]: Filter recognized text by confidence scores.
4. Edit the recognition results if needed.
   • Edit speaker: Click the dropdown menu and select a speaker.
     • : Delete a speaker.
     • : Edit a speaker's name.
     • [Add speaker]: Add a new speaker.
   • Edit text: Click the marked row to edit text, then click to save.
     • To cancel edits, click .
     • Edited content is highlighted in green.
5. To export recognition results, click [Export], enter settings information, and click [OK].
   • File name: Enter a name for the output file.
   • File format: Click on the dropdown menu and select the file format you want to export the file as (select from json, smi, srt, txt, csv, and xls).
   • Shift timeline: Push the timeline backward by a specified amount.
   • Export method: Select Object Storage or Download.
     • For Object Storage, click the file path to select the save location.
     • For Download, the file is saved to your local PC.

Export recognition results

You can export the result files of multiple tasks at once.

1. In the domain's builder, click the Task list menu.
2. Select the tasks you want to export.
   • Multiple tasks can be selected at once.
3. Click [Export].
4. When the Export popup appears, check the export settings and click [OK].
   • : Click to edit the result file name.
   • : Click to delete a task from the export list.
   • File format: Click on the dropdown menu and select the file format you want to export the file as (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, the file is saved to your local PC.

Delete recognition tasks

To delete registered recognition tasks:

1. In the domain's builder, click the Task list menu.
2. Select the task(s) you want to delete.
   • Multiple tasks can be selected 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:

Add keywords

To add keywords you want to boost:

You can add keywords using either method below:

• Upload a keyword file: Upload an Excel file containing keywords to add multiple keywords at once.
• Add keywords individually: Enter keywords directly in the Builder.

Upload keyword file

To upload an Excel file and register multiple keywords at once:

1. Prepare an Excel file containing the keywords and weight values.
   • Weight values must be integers between 1 and 5.
   • In step 4, click Upload template 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 window, or click on the window to select the keyword file.
5. Click [OK].
   • Overwrite: Enable the checkbox to delete all existing keywords and register only the new keywords.

Add keywords individually

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 on the input field and type the keyword.
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 for the keyword you want to edit.
3. Click the keyword input field, edit the keyword, and then click .
   • To cancel editing, click .
   • 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 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 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 integration information required for API calls and the information of the domain connected to the Builder.

Check API call information

To check the integration information required for API calls:

1. In the domain's Builder, click the Settings menu.
2. Click the [Integration information] tab menu.
3. Check the domain's Secret Key and CLOVA Speech Invoke URL.
   • [Create]: Click to create or regenerate the Secret Key.
   • [Copy]: Click 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: Name of the domain.
     • Domain code: Code of the domain.
     • Type: Pricing plan applied to the domain.
   • Storage settings
     • Result file storage path: Object Storage path for saving recognition result files.
     • Input file storage path: Object Storage path for selecting input files.
     • [Go to Object Storage]: Click to move to the Object Storage console interface.