Hotword management

更新时间:
复制 MD 格式

Custom hotwords improve speech recognition accuracy for specific terms and phrases, such as proper nouns, brand names, and domain-specific vocabulary.

Use cases

The automatic speech recognition (ASR) feature of Intelligent Media Services (IMS) accurately recognizes common words in most scenarios, but performance may decrease for proper nouns, brand names, or domain-specific terms. With hotword management, you can add a custom vocabulary to improve recognition for these terms. When words have similar pronunciations, the system prioritizes user-defined hotwords with a higher weight.

Features

  • Improve recognition accuracy for domain-specific terms, such as place names, product names, and uncommon words. For example, "Eiffel Tower" or "12345 service hotline".

  • Address recognition issues for homophones or uncommon words. For example, ensure the system correctly recognizes "four-year" instead of "for year".

  • For video translation scenarios, hotword translation lets you specify translations for specific words or phrases. For example, you can translate 'Intelligent Media Services' to 'IMS' or 'Eternal God (YYDS)' to 'The GOAT'.

Limitations

Manage hotword libraries in the console

  1. Go to the Intelligent Media Services - hotword management page.

  2. In the top-left corner, select the appropriate region.

  3. Click Create Hotword Library.

    The Create Hotword Library dialog box opens. You can enter a Description (up to 300 characters). To add entries manually, click + Add Hotword. For each hotword, set a Language and Weight.

    1. Enter a Name for the hotword library.

    2. Select a Scenario.

      Scenario

      Description

      Video translation

      Setting specific terms as hotwords, such as proper names, company names, and industry-specific terminology, improves recognition accuracy. The hotword substitution feature also lets you customize the output for specific words and phrases. For example, "Intelligent Media Services" can be transcribed as "IMS".

      Note

      In video translation scenarios, this feature supports custom translations. You can define specific translation results for certain words and phrases to improve accuracy and contextual relevance.

      Intelligent media analysis

      Improves recognition accuracy by setting specific terms as hotwords, such as proper names, company names, or industry-specific vocabulary.

      Smart subtitling (ASR)

      Improves recognition accuracy by setting specific terms as hotwords, such as proper names, company names, or industry-specific vocabulary.

    3. Add hotwords by entering them manually or by importing a file.

      Note
      • Before importing a hotword file, click Export to download the template. Edit the Excel file and upload it in .xlsx format. The system overwrites all existing hotwords with the contents of the uploaded file.

      • Do not modify the column names, column order, or other structural information in the exported Excel file.

      • A hotword library can contain a maximum of 300 hotwords.

  4. When finished, click Create. You can then download the library by clicking Export. You can also find the library in the list and click Export in the Actions column.

Manage hotword libraries with API

Workflow

image

Create a hotword library

Call CreateHotwordLibrary to create a hotword library.

List hotword libraries

Call ListHotwordLibraries to retrieve a list of hotword libraries.

Get a hotword library

Call GetHotwordLibrary to get the details of a specific hotword library.

Update a hotword library

Call UpdateHotwordLibrary to update the information of a specific hotword library.

Delete a hotword library

Call DeleteHotwordLibrary to delete a specific hotword library.

Use a hotword library

Supported scenarios

Usage

Video translation

Pass the hotword library ID to the EditingConfig.HotwordLibraryIdList parameter. For best practices, see Use custom hotword libraries.

Intelligent media analysis

Set the AnalysisParams.nlpParams.phraseId parameter of the SubmitMediaAiAnalysisJob request to the specified hotword library ID.

Smart subtitling (ASR)

Set the EditingConfig.HotwordLibraryIdList parameter of the SubmitASRJob request to the specified hotword library ID.

API reference