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.

Launch Builder

To run the Builder:

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:

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. 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 to open the Object Storage console.
   • Result file location: Object Storage path where result files are saved.
     • Click 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).

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

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:

Edit and export recognition results

To 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 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.
     • : Delete a speaker.
     • : Edit a speaker's name.
     • [Add speaker]: Click it to add a speaker.
   • Edit text: Click the row marked as to edit the contents, and click .
     • 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 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:

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].
   • : Click to edit the result file name.
   • : 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:

Add keywords

To add keywords you want to boost:

You can add keywords using either method below:

• Upload keyword files: Enter multiple keywords all at once by uploading an Excel file containing keywords.
• Add individual keywords: 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.

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 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 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:

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.