Class TrainLanguageModelOptions

java.lang.Object
com.ibm.cloud.sdk.core.service.model.GenericModel
com.ibm.watson.speech_to_text.v1.model.TrainLanguageModelOptions
All Implemented Interfaces:
com.ibm.cloud.sdk.core.service.model.ObjectModel

public class TrainLanguageModelOptions
extends com.ibm.cloud.sdk.core.service.model.GenericModel
The trainLanguageModel options.
  • Method Details

    • newBuilder

      public TrainLanguageModelOptions.Builder newBuilder()
      New builder.
      Returns:
      a TrainLanguageModelOptions builder
    • customizationId

      public String customizationId()
      Gets the customizationId.

      The customization ID (GUID) of the custom language model that is to be used for the request. You must make the request with credentials for the instance of the service that owns the custom model.

      Returns:
      the customizationId
    • wordTypeToAdd

      public String wordTypeToAdd()
      Gets the wordTypeToAdd.

      _For custom models that are based on previous-generation models_, the type of words from the custom language model's words resource on which to train the model: * `all` (the default) trains the model on all new words, regardless of whether they were extracted from corpora or grammars or were added or modified by the user. * `user` trains the model only on custom words that were added or modified by the user directly. The model is not trained on new words extracted from corpora or grammars.

      _For custom models that are based on next-generation models_, the service ignores the parameter. The words resource contains only custom words that the user adds or modifies directly, so the parameter is unnecessary.

      Returns:
      the wordTypeToAdd
    • customizationWeight

      public Double customizationWeight()
      Gets the customizationWeight.

      Specifies a customization weight for the custom language model. The customization weight tells the service how much weight to give to words from the custom language model compared to those from the base model for speech recognition. Specify a value between 0.0 and 1.0; the default is 0.3.

      The default value yields the best performance in general. Assign a higher value if your audio makes frequent use of OOV words from the custom model. Use caution when setting the weight: a higher value can improve the accuracy of phrases from the custom model's domain, but it can negatively affect performance on non-domain phrases.

      The value that you assign is used for all recognition requests that use the model. You can override it for any recognition request by specifying a customization weight for that request.

      See [Using customization weight](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageUse#weight).

      Returns:
      the customizationWeight