ibm_watson 1.2.0 → 1.6.0

data/lib/ibm_watson/speech_to_text_v1.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# (C) Copyright IBM Corp. 2020.
+# (C) Copyright IBM Corp. 2018, 2020.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -14,12 +14,12 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# The IBM® Speech to Text service provides APIs that use IBM's speech-recognition
-# capabilities to produce transcripts of spoken audio. The service can transcribe speech
-# from various languages and audio formats. In addition to basic transcription, the
-# service can produce detailed information about many different aspects of the audio. For
-# most languages, the service supports two sampling rates, broadband and narrowband. It
-# returns all JSON response content in the UTF-8 character set.
+# The IBM Watson™ Speech to Text service provides APIs that use IBM's
+# speech-recognition capabilities to produce transcripts of spoken audio. The service can
+# transcribe speech from various languages and audio formats. In addition to basic
+# transcription, the service can produce detailed information about many different aspects
+# of the audio. For most languages, the service supports two sampling rates, broadband and
+# narrowband. It returns all JSON response content in the UTF-8 character set.
 #
 # For speech recognition, the service supports synchronous and asynchronous HTTP
 # Representational State Transfer (REST) interfaces. It also supports a WebSocket
@@ -34,9 +34,9 @@
 # is a formal language specification that lets you restrict the phrases that the service
 # can recognize.
 #
-# Language model customization is generally available for production use with most
-# supported languages. Acoustic model customization is beta functionality that is
-# available for all supported languages.
+# Language model customization and acoustic model customization are generally available
+# for production use with all language models that are generally available. Grammars are
+# beta functionality for all language models that support language model customization.
 
 require "concurrent"
 require "erb"
@@ -50,6 +50,8 @@ module IBMWatson
   # The Speech to Text V1 service.
   class SpeechToTextV1 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
+    DEFAULT_SERVICE_NAME = "speech_to_text"
+    DEFAULT_SERVICE_URL = "https://api.us-south.speech-to-text.watson.cloud.ibm.com"
     ##
     # @!method initialize(args)
     # Construct a new client for the Speech to Text service.
@@ -58,15 +60,19 @@ module IBMWatson
     # @option args service_url [String] The base service URL to use when contacting the service.
     #   The base service_url may differ between IBM Cloud regions.
     # @option args authenticator [Object] The Authenticator instance to be configured for this service.
+    # @option args service_name [String] The name of the service to configure. Will be used as the key to load
+    #   any external configuration, if applicable.
     def initialize(args = {})
       @__async_initialized__ = false
       defaults = {}
-      defaults[:service_url] = "https://stream.watsonplatform.net/speech-to-text/api"
+      defaults[:service_url] = DEFAULT_SERVICE_URL
+      defaults[:service_name] = DEFAULT_SERVICE_NAME
       defaults[:authenticator] = nil
+      user_service_url = args[:service_url] unless args[:service_url].nil?
       args = defaults.merge(args)
-      args[:service_name] = "speech_to_text"
       args[:authenticator] = IBMCloudSdkCore::ConfigBasedAuthenticatorFactory.new.get_authenticator(service_name: args[:service_name]) if args[:authenticator].nil?
       super
+      @service_url = user_service_url unless user_service_url.nil?
     end
 
     #########################
@@ -78,10 +84,11 @@ module IBMWatson
     # List models.
     # Lists all language models that are available for use with the service. The
     #   information includes the name of the model and its minimum sampling rate in Hertz,
-    #   among other things.
+    #   among other things. The ordering of the list of models can change from call to
+    #   call; do not rely on an alphabetized or static list of models.
     #
     #   **See also:** [Languages and
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-models#models).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models#models).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_models
       headers = {
@@ -108,7 +115,7 @@ module IBMWatson
     #   sampling rate in Hertz, among other things.
     #
     #   **See also:** [Languages and
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-models#models).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models#models).
     # @param model_id [String] The identifier of the model in the form of its name from the output of the **Get a
     #   model** method.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
@@ -135,7 +142,7 @@ module IBMWatson
     #########################
 
     ##
-    # @!method recognize(audio:, content_type: nil, model: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil, audio_metrics: nil, end_of_phrase_silence_time: nil, split_transcript_at_phrase_end: nil)
+    # @!method recognize(audio:, content_type: nil, model: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil, audio_metrics: nil, end_of_phrase_silence_time: nil, split_transcript_at_phrase_end: nil, speech_detector_sensitivity: nil, background_audio_suppression: nil)
     # Recognize audio.
     # Sends audio and returns transcription results for a recognition request. You can
     #   pass a maximum of 100 MB and a minimum of 100 bytes of audio with a request. The
@@ -146,7 +153,7 @@ module IBMWatson
     #   upload the file for the request.)
     #
     #   **See also:** [Making a basic HTTP
-    #   request](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-http#HTTP-basic).
+    #   request](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-http#HTTP-basic).
     #
     #
     #   ### Streaming mode
@@ -161,9 +168,9 @@ module IBMWatson
     #
     #   **See also:**
     #   * [Audio
-    #   transmission](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#transmission)
+    #   transmission](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#transmission)
     #   *
-    #   [Timeouts](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#timeouts)
+    #   [Timeouts](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#timeouts)
     #
     #
     #   ### Audio formats (content types)
@@ -203,7 +210,7 @@ module IBMWatson
     #   fails.
     #
     #    **See also:** [Audio
-    #   formats](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
+    #   formats](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
     #
     #
     #   ### Multipart speech recognition
@@ -222,19 +229,19 @@ module IBMWatson
     #   want to spot a very large number of keywords.
     #
     #   **See also:** [Making a multipart HTTP
-    #   request](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-http#HTTP-multi).
+    #   request](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-http#HTTP-multi).
     # @param audio [String] The audio to transcribe.
     # @param content_type [String] The format (MIME type) of the audio. For more information about specifying an
     #   audio format, see **Audio formats (content types)** in the method description.
     # @param model [String] The identifier of the model that is to be used for the recognition request. See
     #   [Languages and
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-models#models).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models#models).
     # @param language_customization_id [String] The customization ID (GUID) of a custom language model that is to be used with the
     #   recognition request. The base model of the specified custom language model must
     #   match the model specified with the `model` parameter. You must make the request
     #   with credentials for the instance of the service that owns the custom model. By
     #   default, no custom language model is used. See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#custom-input).
     #
     #
     #   **Note:** Use this parameter instead of the deprecated `customization_id`
@@ -244,13 +251,13 @@ module IBMWatson
     #   match the model specified with the `model` parameter. You must make the request
     #   with credentials for the instance of the service that owns the custom model. By
     #   default, no custom acoustic model is used. See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#custom-input).
     # @param base_model_version [String] The version of the specified base model that is to be used with the recognition
     #   request. Multiple versions of a base model can exist when a model is updated for
     #   internal improvements. The parameter is intended primarily for use with custom
     #   models that have been upgraded for a new base model. The default value depends on
     #   whether the parameter is used with or without a custom model. See [Base model
-    #   version](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#version).
+    #   version](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#version).
     # @param customization_weight [Float] If you specify the customization ID (GUID) of a custom language model with the
     #   recognition request, 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
@@ -268,45 +275,51 @@ module IBMWatson
     #   phrases.
     #
     #   See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#custom-input).
     # @param inactivity_timeout [Fixnum] The time in seconds after which, if only silence (no speech) is detected in
     #   streaming audio, the connection is closed with a 400 error. The parameter is
     #   useful for stopping audio submission from a live microphone when a user simply
     #   walks away. Use `-1` for infinity. See [Inactivity
-    #   timeout](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#timeouts-inactivity).
+    #   timeout](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#timeouts-inactivity).
     # @param keywords [Array[String]] An array of keyword strings to spot in the audio. Each keyword string can include
     #   one or more string tokens. Keywords are spotted only in the final results, not in
     #   interim hypotheses. If you specify any keywords, you must also specify a keywords
-    #   threshold. You can spot a maximum of 1000 keywords. Omit the parameter or specify
-    #   an empty array if you do not need to spot keywords. See [Keyword
-    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#keyword_spotting).
+    #   threshold. Omit the parameter or specify an empty array if you do not need to spot
+    #   keywords.
+    #
+    #   You can spot a maximum of 1000 keywords with a single request. A single keyword
+    #   can have a maximum length of 1024 characters, though the maximum effective length
+    #   for double-byte languages might be shorter. Keywords are case-insensitive.
+    #
+    #   See [Keyword
+    #   spotting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#keyword_spotting).
     # @param keywords_threshold [Float] A confidence value that is the lower bound for spotting a keyword. A word is
     #   considered to match a keyword if its confidence is greater than or equal to the
     #   threshold. Specify a probability between 0.0 and 1.0. If you specify a threshold,
     #   you must also specify one or more keywords. The service performs no keyword
     #   spotting if you omit either parameter. See [Keyword
-    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#keyword_spotting).
+    #   spotting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#keyword_spotting).
     # @param max_alternatives [Fixnum] The maximum number of alternative transcripts that the service is to return. By
     #   default, the service returns a single transcript. If you specify a value of `0`,
     #   the service uses the default value, `1`. See [Maximum
-    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#max_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#max_alternatives).
     # @param word_alternatives_threshold [Float] A confidence value that is the lower bound for identifying a hypothesis as a
     #   possible word alternative (also known as "Confusion Networks"). An alternative
     #   word is considered if its confidence is greater than or equal to the threshold.
     #   Specify a probability between 0.0 and 1.0. By default, the service computes no
     #   alternative words. See [Word
-    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#word_alternatives).
     # @param word_confidence [Boolean] If `true`, the service returns a confidence measure in the range of 0.0 to 1.0 for
     #   each word. By default, the service returns no word confidence scores. See [Word
-    #   confidence](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_confidence).
+    #   confidence](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#word_confidence).
     # @param timestamps [Boolean] If `true`, the service returns time alignment for each word. By default, no
     #   timestamps are returned. See [Word
-    #   timestamps](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_timestamps).
+    #   timestamps](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#word_timestamps).
     # @param profanity_filter [Boolean] If `true`, the service filters profanity from all output except for keyword
     #   results by replacing inappropriate words with a series of asterisks. Set the
     #   parameter to `false` to return results with no censoring. Applies to US English
     #   transcription only. See [Profanity
-    #   filtering](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#profanity_filter).
+    #   filtering](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#profanity_filter).
     # @param smart_formatting [Boolean] If `true`, the service converts dates, times, series of digits and numbers, phone
     #   numbers, currency values, and internet addresses into more readable, conventional
     #   representations in the final transcript of a recognition request. For US English,
@@ -316,21 +329,19 @@ module IBMWatson
     #   **Note:** Applies to US English, Japanese, and Spanish transcription only.
     #
     #   See [Smart
-    #   formatting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#smart_formatting).
+    #   formatting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#smart_formatting).
     # @param speaker_labels [Boolean] If `true`, the response includes labels that identify which words were spoken by
     #   which participants in a multi-person exchange. By default, the service returns no
     #   speaker labels. Setting `speaker_labels` to `true` forces the `timestamps`
     #   parameter to be `true`, regardless of whether you specify `false` for the
     #   parameter.
     #
-    #   **Note:** Applies to US English, Japanese, and Spanish (both broadband and
-    #   narrowband models) and UK English (narrowband model) transcription only. To
-    #   determine whether a language model supports speaker labels, you can also use the
-    #   **Get a model** method and check that the attribute `speaker_labels` is set to
-    #   `true`.
+    #   **Note:** Applies to US English, Australian English, German, Japanese, Korean, and
+    #   Spanish (both broadband and narrowband models) and UK English (narrowband model)
+    #   transcription only.
     #
     #   See [Speaker
-    #   labels](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#speaker_labels).
+    #   labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#speaker_labels).
     # @param customization_id [String] **Deprecated.** Use the `language_customization_id` parameter to specify the
     #   customization ID (GUID) of a custom language model that is to be used with the
     #   recognition request. Do not specify both parameters with a request.
@@ -339,7 +350,7 @@ module IBMWatson
     #   specify the name of the custom language model for which the grammar is defined.
     #   The service recognizes only strings that are recognized by the specified grammar;
     #   it does not recognize other custom words from the model's words resource. See
-    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#grammars-input).
+    #   [Grammars](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#grammars-input).
     # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
     #   feature redacts any number that has three or more consecutive digits by replacing
     #   each digit with an `X` character. It is intended to redact sensitive numeric data,
@@ -354,13 +365,13 @@ module IBMWatson
     #   **Note:** Applies to US English, Japanese, and Korean transcription only.
     #
     #   See [Numeric
-    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#redaction).
+    #   redaction](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#redaction).
     # @param audio_metrics [Boolean] If `true`, requests detailed information about the signal characteristics of the
     #   input audio. The service returns audio metrics with the final transcription
     #   results. By default, the service returns no audio metrics.
     #
     #   See [Audio
-    #   metrics](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-metrics#audio_metrics).
+    #   metrics](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metrics#audio_metrics).
     # @param end_of_phrase_silence_time [Float] If `true`, specifies the duration of the pause interval at which the service
     #   splits a transcript into multiple final results. If the service detects pauses or
     #   extended silence before it reaches the end of the audio stream, its response can
@@ -377,7 +388,7 @@ module IBMWatson
     #   Chinese is 0.6 seconds.
     #
     #   See [End of phrase silence
-    #   time](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#silence_time).
+    #   time](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#silence_time).
     # @param split_transcript_at_phrase_end [Boolean] If `true`, directs the service to split the transcript into multiple final results
     #   based on semantic features of the input, for example, at the conclusion of
     #   meaningful phrases such as sentences. The service bases its understanding of
@@ -387,9 +398,34 @@ module IBMWatson
     #   interval.
     #
     #   See [Split transcript at phrase
-    #   end](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#split_transcript).
+    #   end](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#split_transcript).
+    # @param speech_detector_sensitivity [Float] The sensitivity of speech activity detection that the service is to perform. Use
+    #   the parameter to suppress word insertions from music, coughing, and other
+    #   non-speech events. The service biases the audio it passes for speech recognition
+    #   by evaluating the input audio against prior models of speech and non-speech
+    #   activity.
+    #
+    #   Specify a value between 0.0 and 1.0:
+    #   * 0.0 suppresses all audio (no speech is transcribed).
+    #   * 0.5 (the default) provides a reasonable compromise for the level of sensitivity.
+    #   * 1.0 suppresses no audio (speech detection sensitivity is disabled).
+    #
+    #   The values increase on a monotonic curve. See [Speech Activity
+    #   Detection](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#detection).
+    # @param background_audio_suppression [Float] The level to which the service is to suppress background audio based on its volume
+    #   to prevent it from being transcribed as speech. Use the parameter to suppress side
+    #   conversations or background noise.
+    #
+    #   Specify a value in the range of 0.0 to 1.0:
+    #   * 0.0 (the default) provides no suppression (background audio suppression is
+    #   disabled).
+    #   * 0.5 provides a reasonable level of audio suppression for general usage.
+    #   * 1.0 suppresses all audio (no audio is transcribed).
+    #
+    #   The values increase on a monotonic curve. See [Speech Activity
+    #   Detection](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#detection).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def recognize(audio:, content_type: nil, model: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil, audio_metrics: nil, end_of_phrase_silence_time: nil, split_transcript_at_phrase_end: nil)
+    def recognize(audio:, content_type: nil, model: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil, audio_metrics: nil, end_of_phrase_silence_time: nil, split_transcript_at_phrase_end: nil, speech_detector_sensitivity: nil, background_audio_suppression: nil)
       raise ArgumentError.new("audio must be provided") if audio.nil?
 
       headers = {
@@ -420,7 +456,9 @@ module IBMWatson
         "redaction" => redaction,
         "audio_metrics" => audio_metrics,
         "end_of_phrase_silence_time" => end_of_phrase_silence_time,
-        "split_transcript_at_phrase_end" => split_transcript_at_phrase_end
+        "split_transcript_at_phrase_end" => split_transcript_at_phrase_end,
+        "speech_detector_sensitivity" => speech_detector_sensitivity,
+        "background_audio_suppression" => background_audio_suppression
       }
 
       data = audio
@@ -439,7 +477,7 @@ module IBMWatson
     end
 
     ##
-    # @!method recognize_using_websocket(content_type: nil,recognize_callback:,audio: nil,chunk_data: false,model: nil,customization_id: nil,acoustic_customization_id: nil,customization_weight: nil,base_model_version: nil,inactivity_timeout: nil,interim_results: nil,keywords: nil,keywords_threshold: nil,max_alternatives: nil,word_alternatives_threshold: nil,word_confidence: nil,timestamps: nil,profanity_filter: nil,smart_formatting: nil,speaker_labels: nil, end_of_phrase_silence_time: nil, split_transcript_at_phrase_end: nil)
+    # @!method recognize_using_websocket(content_type: nil,recognize_callback:,audio: nil,chunk_data: false,model: nil,customization_id: nil,acoustic_customization_id: nil,customization_weight: nil,base_model_version: nil,inactivity_timeout: nil,interim_results: nil,keywords: nil,keywords_threshold: nil,max_alternatives: nil,word_alternatives_threshold: nil,word_confidence: nil,timestamps: nil,profanity_filter: nil,smart_formatting: nil,speaker_labels: nil, end_of_phrase_silence_time: nil, split_transcript_at_phrase_end: nil, speech_detector_sensitivity: nil, background_audio_suppression: nil)
     # Sends audio for speech recognition using web sockets.
     # @param content_type [String] The type of the input: audio/basic, audio/flac, audio/l16, audio/mp3, audio/mpeg, audio/mulaw, audio/ogg, audio/ogg;codecs=opus, audio/ogg;codecs=vorbis, audio/wav, audio/webm, audio/webm;codecs=opus, audio/webm;codecs=vorbis, or multipart/form-data.
     # @param recognize_callback [RecognizeCallback] The instance handling events returned from the service.
@@ -449,7 +487,7 @@ module IBMWatson
     # @param customization_id [String] The GUID of a custom language model that is to be used with the request. The base model of the specified custom language model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom language model is used.
     # @param acoustic_customization_id [String] The GUID of a custom acoustic model that is to be used with the request. The base model of the specified custom acoustic model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom acoustic model is used.
     # @param language_customization_id [String] The GUID of a custom language model that is to be used with the request. The base model of the specified custom language model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom language model is used.
-    # @param base_model_version [String] The version of the specified base `model` that is to be used for speech recognition. Multiple versions of a base model can exist when a model is updated for internal improvements. The parameter is intended primarily for use with custom models that have been upgraded for a new base model. The default value depends on whether the parameter is used with or without a custom model. For more information, see [Base model version](https://console.bluemix.net/docs/services/speech-to-text/input.html#version).
+    # @param base_model_version [String] The version of the specified base `model` that is to be used for speech recognition. Multiple versions of a base model can exist when a model is updated for internal improvements. The parameter is intended primarily for use with custom models that have been upgraded for a new base model. The default value depends on whether the parameter is used with or without a custom model. For more information, see [Base model version](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#version).
     # @param inactivity_timeout [Integer] The time in seconds after which, if only silence (no speech) is detected in submitted audio, the connection is closed with a 400 error. Useful for stopping audio submission from a live microphone when a user simply walks away. Use `-1` for infinity.
     # @param interim_results [Boolean] Send back non-final previews of each "sentence" as it is being processed. These results are ignored in text mode.
     # @param keywords [Array<String>] Array of keyword strings to spot in the audio. Each keyword string can include one or more tokens. Keywords are spotted only in the final hypothesis, not in interim results. If you specify any keywords, you must also specify a keywords threshold. Omit the parameter or specify an empty array if you do not need to spot keywords.
@@ -460,13 +498,13 @@ module IBMWatson
     # @param timestamps [Boolean] If `true`, time alignment for each word is returned.
     # @param profanity_filter [Boolean] If `true` (the default), filters profanity from all output except for keyword results by replacing inappropriate words with a series of asterisks. Set the parameter to `false` to return results with no censoring. Applies to US English transcription only.
     # @param smart_formatting [Boolean] If `true`, converts dates, times, series of digits and numbers, phone numbers, currency values, and Internet addresses into more readable, conventional representations in the final transcript of a recognition request. If `false` (the default), no formatting is performed. Applies to US English transcription only.
-    # @param speaker_labels [Boolean] Indicates whether labels that identify which words were spoken by which participants in a multi-person exchange are to be included in the response. The default is `false`; no speaker labels are returned. Setting `speaker_labels` to `true` forces the `timestamps` parameter to be `true`, regardless of whether you specify `false` for the parameter.   To determine whether a language model supports speaker labels, use the `GET /v1/models` method and check that the attribute `speaker_labels` is set to `true`. You can also refer to [Speaker labels](https://console.bluemix.net/docs/services/speech-to-text/output.html#speaker_labels).
+    # @param speaker_labels [Boolean] Indicates whether labels that identify which words were spoken by which participants in a multi-person exchange are to be included in the response. The default is `false`; no speaker labels are returned. Setting `speaker_labels` to `true` forces the `timestamps` parameter to be `true`, regardless of whether you specify `false` for the parameter.   To determine whether a language model supports speaker labels, use the `GET /v1/models` method and check that the attribute `speaker_labels` is set to `true`. You can also refer to [Speaker labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#speaker_labels).
     # @param grammar_name [String] The name of a grammar that is to be used with the recognition request. If you
     #   specify a grammar, you must also use the `language_customization_id` parameter to
     #   specify the name of the custom language model for which the grammar is defined.
     #   The service recognizes only strings that are recognized by the specified grammar;
     #   it does not recognize other custom words from the model's words resource. See
-    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text/output.html).
+    #   [Grammars](https://cloud.ibm.com/docs/speech-to-text/output.html).
     # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
     #   feature redacts any number that has three or more consecutive digits by replacing
     #   each digit with an `X` character. It is intended to redact sensitive numeric data,
@@ -481,7 +519,7 @@ module IBMWatson
     #   **Note:** Applies to US English, Japanese, and Korean transcription only.
     #
     #   See [Numeric
-    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text/output.html#redaction).
+    #   redaction](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#redaction).
     #
     # @param processing_metrics [Boolean] If `true`, requests processing metrics about the service's transcription of the
     #   input audio. The service returns processing metrics at the interval specified by
@@ -503,7 +541,7 @@ module IBMWatson
     # @return [WebSocketClient] Returns a new WebSocketClient object
     #
     #   See [Audio
-    #   metrics](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-metrics#audio_metrics).
+    #   metrics](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metrics#audio_metrics).
     # @param end_of_phrase_silence_time [Float] If `true`, specifies the duration of the pause interval at which the service
     #   splits a transcript into multiple final results. If the service detects pauses or
     #   extended silence before it reaches the end of the audio stream, its response can
@@ -520,7 +558,7 @@ module IBMWatson
     #   Chinese is 0.6 seconds.
     #
     #   See [End of phrase silence
-    #   time](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#silence_time).
+    #   time](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#silence_time).
     # @param split_transcript_at_phrase_end [Boolean] If `true`, directs the service to split the transcript into multiple final results
     #   based on semantic features of the input, for example, at the conclusion of
     #   meaningful phrases such as sentences. The service bases its understanding of
@@ -530,7 +568,33 @@ module IBMWatson
     #   interval.
     #
     #   See [Split transcript at phrase
-    #   end](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#split_transcript).
+    #   end](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#split_transcript).
+    # @param speech_detector_sensitivity [Float] The sensitivity of speech activity detection that the service is to perform. Use
+    #   the parameter to suppress word insertions from music, coughing, and other
+    #   non-speech events. The service biases the audio it passes for speech recognition
+    #   by evaluating the input audio against prior models of speech and non-speech
+    #   activity.
+    #
+    #   Specify a value between 0.0 and 1.0:
+    #   * 0.0 suppresses all audio (no speech is transcribed).
+    #   * 0.5 (the default) provides a reasonable compromise for the level of sensitivity.
+    #   * 1.0 suppresses no audio (speech detection sensitivity is disabled).
+    #
+    #   The values increase on a monotonic curve. See [Speech Activity
+    #   Detection](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#detection).
+    # @param background_audio_suppression [Float] The level to which the service is to suppress background audio based on its volume
+    #   to prevent it from being transcribed as speech. Use the parameter to suppress side
+    #   conversations or background noise.
+    #
+    #   Specify a value in the range of 0.0 to 1.0:
+    #   * 0.0 (the default) provides no suppression (background audio suppression is
+    #   disabled).
+    #   * 0.5 provides a reasonable level of audio suppression for general usage.
+    #   * 1.0 suppresses all audio (no audio is transcribed).
+    #
+    #   The values increase on a monotonic curve. See [Speech Activity
+    #   Detection](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#detection).
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def recognize_using_websocket(
       content_type: nil,
       recognize_callback:,
@@ -559,7 +623,9 @@ module IBMWatson
       processing_metrics_interval: nil,
       audio_metrics: nil,
       end_of_phrase_silence_time: nil,
-      split_transcript_at_phrase_end: nil
+      split_transcript_at_phrase_end: nil,
+      speech_detector_sensitivity: nil,
+      background_audio_suppression: nil
     )
       raise ArgumentError("Audio must be provided") if audio.nil? && !chunk_data
       raise ArgumentError("Recognize callback must be provided") if recognize_callback.nil?
@@ -568,6 +634,7 @@ module IBMWatson
       require_relative("./websocket/speech_to_text_websocket_listener.rb")
       headers = {}
       headers = conn.default_options.headers.to_hash unless conn.default_options.headers.to_hash.empty?
+      @authenticator.authenticate(headers)
       service_url = @service_url.gsub("https:", "wss:")
       params = {
         "model" => model,
@@ -598,7 +665,9 @@ module IBMWatson
         "processing_metrics_interval" => processing_metrics_interval,
         "audio_metrics" => audio_metrics,
         "end_of_phrase_silence_time" => end_of_phrase_silence_time,
-        "split_transcript_at_phrase_end" => split_transcript_at_phrase_end
+        "split_transcript_at_phrase_end" => split_transcript_at_phrase_end,
+        "speech_detector_sensitivity" => speech_detector_sensitivity,
+        "background_audio_suppression" => background_audio_suppression
       }
       options.delete_if { |_, v| v.nil? }
       WebSocketClient.new(audio: audio, chunk_data: chunk_data, options: options, recognize_callback: recognize_callback, service_url: service_url, headers: headers, disable_ssl_verification: @disable_ssl_verification)
@@ -611,9 +680,9 @@ module IBMWatson
     # @!method register_callback(callback_url:, user_secret: nil)
     # Register a callback.
     # Registers a callback URL with the service for use with subsequent asynchronous
-    #   recognition requests. The service attempts to register, or white-list, the
-    #   callback URL if it is not already registered by sending a `GET` request to the
-    #   callback URL. The service passes a random alphanumeric challenge string via the
+    #   recognition requests. The service attempts to register, or allowlist, the callback
+    #   URL if it is not already registered by sending a `GET` request to the callback
+    #   URL. The service passes a random alphanumeric challenge string via the
     #   `challenge_string` parameter of the request. The request includes an `Accept`
     #   header that specifies `text/plain` as the required response type.
     #
@@ -625,9 +694,9 @@ module IBMWatson
     #
     #   The service sends only a single `GET` request to the callback URL. If the service
     #   does not receive a reply with a response code of 200 and a body that echoes the
-    #   challenge string sent by the service within five seconds, it does not white-list
+    #   challenge string sent by the service within five seconds, it does not allowlist
     #   the URL; it instead sends status code 400 in response to the **Register a
-    #   callback** request. If the requested callback URL is already white-listed, the
+    #   callback** request. If the requested callback URL is already allowlisted, the
     #   service responds to the initial registration request with response code 200.
     #
     #   If you specify a user secret with the request, the service uses it as a key to
@@ -643,9 +712,9 @@ module IBMWatson
     #   a one-hour span of time.
     #
     #   **See also:** [Registering a callback
-    #   URL](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#register).
+    #   URL](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#register).
     # @param callback_url [String] An HTTP or HTTPS URL to which callback notifications are to be sent. To be
-    #   white-listed, the URL must successfully echo the challenge string during URL
+    #   allowlisted, the URL must successfully echo the challenge string during URL
     #   verification. During verification, the client can also check the signature that
     #   the service sends in the `X-Callback-Signature` header to verify the origin of the
     #   request.
@@ -683,12 +752,12 @@ module IBMWatson
     ##
     # @!method unregister_callback(callback_url:)
     # Unregister a callback.
-    # Unregisters a callback URL that was previously white-listed with a **Register a
+    # Unregisters a callback URL that was previously allowlisted with a **Register a
     #   callback** request for use with the asynchronous interface. Once unregistered, the
     #   URL can no longer be used with asynchronous recognition requests.
     #
     #   **See also:** [Unregistering a callback
-    #   URL](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#unregister).
+    #   URL](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#unregister).
     # @param callback_url [String] The callback URL that is to be unregistered.
     # @return [nil]
     def unregister_callback(callback_url:)
@@ -716,7 +785,7 @@ module IBMWatson
     end
 
     ##
-    # @!method create_job(audio:, content_type: nil, model: nil, callback_url: nil, events: nil, user_token: nil, results_ttl: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil, processing_metrics: nil, processing_metrics_interval: nil, audio_metrics: nil, end_of_phrase_silence_time: nil, split_transcript_at_phrase_end: nil)
+    # @!method create_job(audio:, content_type: nil, model: nil, callback_url: nil, events: nil, user_token: nil, results_ttl: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil, processing_metrics: nil, processing_metrics_interval: nil, audio_metrics: nil, end_of_phrase_silence_time: nil, split_transcript_at_phrase_end: nil, speech_detector_sensitivity: nil, background_audio_suppression: nil)
     # Create a job.
     # Creates a job for a new asynchronous recognition request. The job is owned by the
     #   instance of the service whose credentials are used to create it. How you learn the
@@ -756,7 +825,7 @@ module IBMWatson
     #   option to upload the file for the request.)
     #
     #   **See also:** [Creating a
-    #   job](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#create).
+    #   job](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#create).
     #
     #
     #   ### Streaming mode
@@ -771,9 +840,9 @@ module IBMWatson
     #
     #   **See also:**
     #   * [Audio
-    #   transmission](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#transmission)
+    #   transmission](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#transmission)
     #   *
-    #   [Timeouts](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#timeouts)
+    #   [Timeouts](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#timeouts)
     #
     #
     #   ### Audio formats (content types)
@@ -813,15 +882,15 @@ module IBMWatson
     #   fails.
     #
     #    **See also:** [Audio
-    #   formats](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
+    #   formats](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
     # @param audio [String] The audio to transcribe.
     # @param content_type [String] The format (MIME type) of the audio. For more information about specifying an
     #   audio format, see **Audio formats (content types)** in the method description.
     # @param model [String] The identifier of the model that is to be used for the recognition request. See
     #   [Languages and
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-models#models).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models#models).
     # @param callback_url [String] A URL to which callback notifications are to be sent. The URL must already be
-    #   successfully white-listed by using the **Register a callback** method. You can
+    #   successfully allowlisted by using the **Register a callback** method. You can
     #   include the same callback URL with any number of job creation requests. Omit the
     #   parameter to poll the service for job completion and results.
     #
@@ -859,7 +928,7 @@ module IBMWatson
     #   match the model specified with the `model` parameter. You must make the request
     #   with credentials for the instance of the service that owns the custom model. By
     #   default, no custom language model is used. See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#custom-input).
     #
     #
     #   **Note:** Use this parameter instead of the deprecated `customization_id`
@@ -869,13 +938,13 @@ module IBMWatson
     #   match the model specified with the `model` parameter. You must make the request
     #   with credentials for the instance of the service that owns the custom model. By
     #   default, no custom acoustic model is used. See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#custom-input).
     # @param base_model_version [String] The version of the specified base model that is to be used with the recognition
     #   request. Multiple versions of a base model can exist when a model is updated for
     #   internal improvements. The parameter is intended primarily for use with custom
     #   models that have been upgraded for a new base model. The default value depends on
     #   whether the parameter is used with or without a custom model. See [Base model
-    #   version](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#version).
+    #   version](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#version).
     # @param customization_weight [Float] If you specify the customization ID (GUID) of a custom language model with the
     #   recognition request, 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
@@ -893,45 +962,51 @@ module IBMWatson
     #   phrases.
     #
     #   See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#custom-input).
     # @param inactivity_timeout [Fixnum] The time in seconds after which, if only silence (no speech) is detected in
     #   streaming audio, the connection is closed with a 400 error. The parameter is
     #   useful for stopping audio submission from a live microphone when a user simply
     #   walks away. Use `-1` for infinity. See [Inactivity
-    #   timeout](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#timeouts-inactivity).
+    #   timeout](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#timeouts-inactivity).
     # @param keywords [Array[String]] An array of keyword strings to spot in the audio. Each keyword string can include
     #   one or more string tokens. Keywords are spotted only in the final results, not in
     #   interim hypotheses. If you specify any keywords, you must also specify a keywords
-    #   threshold. You can spot a maximum of 1000 keywords. Omit the parameter or specify
-    #   an empty array if you do not need to spot keywords. See [Keyword
-    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#keyword_spotting).
+    #   threshold. Omit the parameter or specify an empty array if you do not need to spot
+    #   keywords.
+    #
+    #   You can spot a maximum of 1000 keywords with a single request. A single keyword
+    #   can have a maximum length of 1024 characters, though the maximum effective length
+    #   for double-byte languages might be shorter. Keywords are case-insensitive.
+    #
+    #   See [Keyword
+    #   spotting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#keyword_spotting).
     # @param keywords_threshold [Float] A confidence value that is the lower bound for spotting a keyword. A word is
     #   considered to match a keyword if its confidence is greater than or equal to the
     #   threshold. Specify a probability between 0.0 and 1.0. If you specify a threshold,
     #   you must also specify one or more keywords. The service performs no keyword
     #   spotting if you omit either parameter. See [Keyword
-    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#keyword_spotting).
+    #   spotting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#keyword_spotting).
     # @param max_alternatives [Fixnum] The maximum number of alternative transcripts that the service is to return. By
     #   default, the service returns a single transcript. If you specify a value of `0`,
     #   the service uses the default value, `1`. See [Maximum
-    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#max_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#max_alternatives).
     # @param word_alternatives_threshold [Float] A confidence value that is the lower bound for identifying a hypothesis as a
     #   possible word alternative (also known as "Confusion Networks"). An alternative
     #   word is considered if its confidence is greater than or equal to the threshold.
     #   Specify a probability between 0.0 and 1.0. By default, the service computes no
     #   alternative words. See [Word
-    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#word_alternatives).
     # @param word_confidence [Boolean] If `true`, the service returns a confidence measure in the range of 0.0 to 1.0 for
     #   each word. By default, the service returns no word confidence scores. See [Word
-    #   confidence](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_confidence).
+    #   confidence](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#word_confidence).
     # @param timestamps [Boolean] If `true`, the service returns time alignment for each word. By default, no
     #   timestamps are returned. See [Word
-    #   timestamps](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_timestamps).
+    #   timestamps](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#word_timestamps).
     # @param profanity_filter [Boolean] If `true`, the service filters profanity from all output except for keyword
     #   results by replacing inappropriate words with a series of asterisks. Set the
     #   parameter to `false` to return results with no censoring. Applies to US English
     #   transcription only. See [Profanity
-    #   filtering](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#profanity_filter).
+    #   filtering](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#profanity_filter).
     # @param smart_formatting [Boolean] If `true`, the service converts dates, times, series of digits and numbers, phone
     #   numbers, currency values, and internet addresses into more readable, conventional
     #   representations in the final transcript of a recognition request. For US English,
@@ -941,21 +1016,19 @@ module IBMWatson
     #   **Note:** Applies to US English, Japanese, and Spanish transcription only.
     #
     #   See [Smart
-    #   formatting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#smart_formatting).
+    #   formatting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#smart_formatting).
     # @param speaker_labels [Boolean] If `true`, the response includes labels that identify which words were spoken by
     #   which participants in a multi-person exchange. By default, the service returns no
     #   speaker labels. Setting `speaker_labels` to `true` forces the `timestamps`
     #   parameter to be `true`, regardless of whether you specify `false` for the
     #   parameter.
     #
-    #   **Note:** Applies to US English, Japanese, and Spanish (both broadband and
-    #   narrowband models) and UK English (narrowband model) transcription only. To
-    #   determine whether a language model supports speaker labels, you can also use the
-    #   **Get a model** method and check that the attribute `speaker_labels` is set to
-    #   `true`.
+    #   **Note:** Applies to US English, Australian English, German, Japanese, Korean, and
+    #   Spanish (both broadband and narrowband models) and UK English (narrowband model)
+    #   transcription only.
     #
     #   See [Speaker
-    #   labels](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#speaker_labels).
+    #   labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#speaker_labels).
     # @param customization_id [String] **Deprecated.** Use the `language_customization_id` parameter to specify the
     #   customization ID (GUID) of a custom language model that is to be used with the
     #   recognition request. Do not specify both parameters with a request.
@@ -964,7 +1037,7 @@ module IBMWatson
     #   specify the name of the custom language model for which the grammar is defined.
     #   The service recognizes only strings that are recognized by the specified grammar;
     #   it does not recognize other custom words from the model's words resource. See
-    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#grammars-input).
+    #   [Grammars](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#grammars-input).
     # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
     #   feature redacts any number that has three or more consecutive digits by replacing
     #   each digit with an `X` character. It is intended to redact sensitive numeric data,
@@ -979,7 +1052,7 @@ module IBMWatson
     #   **Note:** Applies to US English, Japanese, and Korean transcription only.
     #
     #   See [Numeric
-    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#redaction).
+    #   redaction](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#redaction).
     # @param processing_metrics [Boolean] If `true`, requests processing metrics about the service's transcription of the
     #   input audio. The service returns processing metrics at the interval specified by
     #   the `processing_metrics_interval` parameter. It also returns processing metrics
@@ -987,7 +1060,7 @@ module IBMWatson
     #   the service returns no processing metrics.
     #
     #   See [Processing
-    #   metrics](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-metrics#processing_metrics).
+    #   metrics](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metrics#processing_metrics).
     # @param processing_metrics_interval [Float] Specifies the interval in real wall-clock seconds at which the service is to
     #   return processing metrics. The parameter is ignored unless the
     #   `processing_metrics` parameter is set to `true`.
@@ -1001,13 +1074,13 @@ module IBMWatson
     #   the service returns processing metrics only for transcription events.
     #
     #   See [Processing
-    #   metrics](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-metrics#processing_metrics).
+    #   metrics](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metrics#processing_metrics).
     # @param audio_metrics [Boolean] If `true`, requests detailed information about the signal characteristics of the
     #   input audio. The service returns audio metrics with the final transcription
     #   results. By default, the service returns no audio metrics.
     #
     #   See [Audio
-    #   metrics](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-metrics#audio_metrics).
+    #   metrics](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metrics#audio_metrics).
     # @param end_of_phrase_silence_time [Float] If `true`, specifies the duration of the pause interval at which the service
     #   splits a transcript into multiple final results. If the service detects pauses or
     #   extended silence before it reaches the end of the audio stream, its response can
@@ -1024,7 +1097,7 @@ module IBMWatson
     #   Chinese is 0.6 seconds.
     #
     #   See [End of phrase silence
-    #   time](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#silence_time).
+    #   time](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#silence_time).
     # @param split_transcript_at_phrase_end [Boolean] If `true`, directs the service to split the transcript into multiple final results
     #   based on semantic features of the input, for example, at the conclusion of
     #   meaningful phrases such as sentences. The service bases its understanding of
@@ -1034,9 +1107,34 @@ module IBMWatson
     #   interval.
     #
     #   See [Split transcript at phrase
-    #   end](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#split_transcript).
+    #   end](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#split_transcript).
+    # @param speech_detector_sensitivity [Float] The sensitivity of speech activity detection that the service is to perform. Use
+    #   the parameter to suppress word insertions from music, coughing, and other
+    #   non-speech events. The service biases the audio it passes for speech recognition
+    #   by evaluating the input audio against prior models of speech and non-speech
+    #   activity.
+    #
+    #   Specify a value between 0.0 and 1.0:
+    #   * 0.0 suppresses all audio (no speech is transcribed).
+    #   * 0.5 (the default) provides a reasonable compromise for the level of sensitivity.
+    #   * 1.0 suppresses no audio (speech detection sensitivity is disabled).
+    #
+    #   The values increase on a monotonic curve. See [Speech Activity
+    #   Detection](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#detection).
+    # @param background_audio_suppression [Float] The level to which the service is to suppress background audio based on its volume
+    #   to prevent it from being transcribed as speech. Use the parameter to suppress side
+    #   conversations or background noise.
+    #
+    #   Specify a value in the range of 0.0 to 1.0:
+    #   * 0.0 (the default) provides no suppression (background audio suppression is
+    #   disabled).
+    #   * 0.5 provides a reasonable level of audio suppression for general usage.
+    #   * 1.0 suppresses all audio (no audio is transcribed).
+    #
+    #   The values increase on a monotonic curve. See [Speech Activity
+    #   Detection](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#detection).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def create_job(audio:, content_type: nil, model: nil, callback_url: nil, events: nil, user_token: nil, results_ttl: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil, processing_metrics: nil, processing_metrics_interval: nil, audio_metrics: nil, end_of_phrase_silence_time: nil, split_transcript_at_phrase_end: nil)
+    def create_job(audio:, content_type: nil, model: nil, callback_url: nil, events: nil, user_token: nil, results_ttl: nil, language_customization_id: nil, acoustic_customization_id: nil, base_model_version: nil, customization_weight: nil, inactivity_timeout: nil, keywords: nil, keywords_threshold: nil, max_alternatives: nil, word_alternatives_threshold: nil, word_confidence: nil, timestamps: nil, profanity_filter: nil, smart_formatting: nil, speaker_labels: nil, customization_id: nil, grammar_name: nil, redaction: nil, processing_metrics: nil, processing_metrics_interval: nil, audio_metrics: nil, end_of_phrase_silence_time: nil, split_transcript_at_phrase_end: nil, speech_detector_sensitivity: nil, background_audio_suppression: nil)
       raise ArgumentError.new("audio must be provided") if audio.nil?
 
       headers = {
@@ -1073,7 +1171,9 @@ module IBMWatson
         "processing_metrics_interval" => processing_metrics_interval,
         "audio_metrics" => audio_metrics,
         "end_of_phrase_silence_time" => end_of_phrase_silence_time,
-        "split_transcript_at_phrase_end" => split_transcript_at_phrase_end
+        "split_transcript_at_phrase_end" => split_transcript_at_phrase_end,
+        "speech_detector_sensitivity" => speech_detector_sensitivity,
+        "background_audio_suppression" => background_audio_suppression
       }
 
       data = audio
@@ -1104,7 +1204,7 @@ module IBMWatson
     #   first.
     #
     #   **See also:** [Checking the status of the latest
-    #   jobs](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#jobs).
+    #   jobs](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#jobs).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def check_jobs
       headers = {
@@ -1139,7 +1239,7 @@ module IBMWatson
     #   recent jobs associated with the calling credentials.
     #
     #   **See also:** [Checking the status and retrieving the results of a
-    #   job](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#job).
+    #   job](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#job).
     # @param id [String] The identifier of the asynchronous job that is to be used for the request. You
     #   must make the request with credentials for the instance of the service that owns
     #   the job.
@@ -1173,7 +1273,7 @@ module IBMWatson
     #   owns a job to delete it.
     #
     #   **See also:** [Deleting a
-    #   job](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#delete-async).
+    #   job](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#delete-async).
     # @param id [String] The identifier of the asynchronous job that is to be used for the request. You
     #   must make the request with credentials for the instance of the service that owns
     #   the job.
@@ -1214,7 +1314,7 @@ module IBMWatson
     #   below the limit.
     #
     #   **See also:** [Create a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-languageCreate#createModel-language).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#createModel-language).
     # @param name [String] A user-defined name for the new custom language model. Use a name that is unique
     #   among all custom language models that you own. Use a localized name that matches
     #   the language of the custom model. Use a name that describes the domain of the
@@ -1226,7 +1326,7 @@ module IBMWatson
     #   To determine whether a base model supports language model customization, use the
     #   **Get a model** method and check that the attribute `custom_language_model` is set
     #   to `true`. You can also refer to [Language support for
-    #   customization](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-customization#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
     # @param dialect [String] The dialect of the specified language that is to be used with the custom language
     #   model. For most languages, the dialect matches the language of the base model by
     #   default. For example, `en-US` is used for either of the US English language
@@ -1288,10 +1388,12 @@ module IBMWatson
     #   a model to list information about it.
     #
     #   **See also:** [Listing custom language
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language).
     # @param language [String] The identifier of the language for which custom language or custom acoustic models
-    #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
-    #   language or custom acoustic models that are owned by the requesting credentials.
+    #   are to be returned. Omit the parameter to see all custom language or custom
+    #   acoustic models that are owned by the requesting credentials. **Note:** The
+    #   `ar-AR` (Modern Standard Arabic) and `zh-CN` (Mandarin Chinese) languages are not
+    #   available for language model customization.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_language_models(language: nil)
       headers = {
@@ -1322,7 +1424,7 @@ module IBMWatson
     #   for the instance of the service that owns a model to list information about it.
     #
     #   **See also:** [Listing custom language
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language).
     # @param customization_id [String] 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.
@@ -1355,7 +1457,7 @@ module IBMWatson
     #   owns a model to delete it.
     #
     #   **See also:** [Deleting a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageLanguageModels#deleteModel-language).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#deleteModel-language).
     # @param customization_id [String] 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.
@@ -1403,7 +1505,7 @@ module IBMWatson
     #   requests to add new resources until the existing request completes.
     #
     #   **See also:** [Train the custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-languageCreate#trainModel-language).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#trainModel-language).
     #
     #
     #   ### Training failures
@@ -1479,7 +1581,7 @@ module IBMWatson
     #   it.
     #
     #   **See also:** [Resetting a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageLanguageModels#resetModel-language).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#resetModel-language).
     # @param customization_id [String] 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.
@@ -1523,7 +1625,7 @@ module IBMWatson
     #   subsequent requests for the model until the upgrade completes.
     #
     #   **See also:** [Upgrading a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-customUpgrade#upgradeLanguage).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customUpgrade#upgradeLanguage).
     # @param customization_id [String] 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.
@@ -1559,7 +1661,7 @@ module IBMWatson
     #   that owns a model to list its corpora.
     #
     #   **See also:** [Listing corpora for a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageCorpora#listCorpora).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageCorpora#listCorpora).
     # @param customization_id [String] 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.
@@ -1599,18 +1701,20 @@ module IBMWatson
     #
     #   The call returns an HTTP 201 response code if the corpus is valid. The service
     #   then asynchronously processes the contents of the corpus and automatically
-    #   extracts new words that it finds. This can take on the order of a minute or two to
-    #   complete depending on the total number of words and the number of new words in the
-    #   corpus, as well as the current load on the service. You cannot submit requests to
-    #   add additional resources to the custom model or to train the model until the
+    #   extracts new words that it finds. This operation can take on the order of minutes
+    #   to complete depending on the total number of words and the number of new words in
+    #   the corpus, as well as the current load on the service. You cannot submit requests
+    #   to add additional resources to the custom model or to train the model until the
     #   service's analysis of the corpus for the current request completes. Use the **List
     #   a corpus** method to check the status of the analysis.
     #
     #   The service auto-populates the model's words resource with words from the corpus
-    #   that are not found in its base vocabulary. These are referred to as
-    #   out-of-vocabulary (OOV) words. You can use the **List custom words** method to
-    #   examine the words resource. You can use other words method to eliminate typos and
-    #   modify how words are pronounced as needed.
+    #   that are not found in its base vocabulary. These words are referred to as
+    #   out-of-vocabulary (OOV) words. After adding a corpus, you must validate the words
+    #   resource to ensure that each OOV word's definition is complete and valid. You can
+    #   use the **List custom words** method to examine the words resource. You can use
+    #   other words method to eliminate typos and modify how words are pronounced as
+    #   needed.
     #
     #   To add a corpus file that has the same name as an existing corpus, set the
     #   `allow_overwrite` parameter to `true`; otherwise, the request fails. Overwriting
@@ -1627,10 +1731,12 @@ module IBMWatson
     #   directly.
     #
     #   **See also:**
-    #   * [Working with
-    #   corpora](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#workingCorpora)
     #   * [Add a corpus to the custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-languageCreate#addCorpus).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#addCorpus)
+    #   * [Working with
+    #   corpora](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingCorpora)
+    #   * [Validating a words
+    #   resource](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel).
     # @param customization_id [String] 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.
@@ -1656,7 +1762,7 @@ module IBMWatson
     #   Make sure that you know the character encoding of the file. You must use that
     #   encoding when working with the words in the custom language model. For more
     #   information, see [Character
-    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
     #
     #
     #   With the `curl` command, use the `--data-binary` option to upload the file for the
@@ -1710,7 +1816,7 @@ module IBMWatson
     #   that owns a model to list its corpora.
     #
     #   **See also:** [Listing corpora for a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageCorpora#listCorpora).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageCorpora#listCorpora).
     # @param customization_id [String] 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.
@@ -1750,7 +1856,7 @@ module IBMWatson
     #   corpora.
     #
     #   **See also:** [Deleting a corpus from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageCorpora#deleteCorpus).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageCorpora#deleteCorpus).
     # @param customization_id [String] 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.
@@ -1792,7 +1898,7 @@ module IBMWatson
     #   service that owns a model to list information about its words.
     #
     #   **See also:** [Listing words from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageWords#listWords).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageWords#listWords).
     # @param customization_id [String] 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.
@@ -1859,7 +1965,10 @@ module IBMWatson
     #   the parameter for words that are difficult to pronounce, foreign words, acronyms,
     #   and so on. For example, you might specify that the word `IEEE` can sound like `i
     #   triple e`. You can specify a maximum of five sounds-like pronunciations for a
-    #   word.
+    #   word. If you omit the `sounds_like` field, the service attempts to set the field
+    #   to its pronunciation of the word. It cannot generate a pronunciation for all
+    #   words, so you must review the word's definition to ensure that it is complete and
+    #   valid.
     #   * The `display_as` field provides a different way of spelling the word in a
     #   transcript. Use the parameter when you want the word to appear different from its
     #   usual representation or from its spelling in training data. For example, you might
@@ -1889,10 +1998,12 @@ module IBMWatson
     #
     #
     #   **See also:**
-    #   * [Working with custom
-    #   words](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
     #   * [Add words to the custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-languageCreate#addWords).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#addWords)
+    #   * [Working with custom
+    #   words](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
+    #   * [Validating a words
+    #   resource](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel).
     # @param customization_id [String] 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.
@@ -1948,7 +2059,10 @@ module IBMWatson
     #   the parameter for words that are difficult to pronounce, foreign words, acronyms,
     #   and so on. For example, you might specify that the word `IEEE` can sound like `i
     #   triple e`. You can specify a maximum of five sounds-like pronunciations for a
-    #   word.
+    #   word. If you omit the `sounds_like` field, the service attempts to set the field
+    #   to its pronunciation of the word. It cannot generate a pronunciation for all
+    #   words, so you must review the word's definition to ensure that it is complete and
+    #   valid.
     #   * The `display_as` field provides a different way of spelling the word in a
     #   transcript. Use the parameter when you want the word to appear different from its
     #   usual representation or from its spelling in training data. For example, you might
@@ -1960,10 +2074,12 @@ module IBMWatson
     #   the **List a custom word** method to review the word that you add.
     #
     #   **See also:**
-    #   * [Working with custom
-    #   words](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
     #   * [Add words to the custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-languageCreate#addWords).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#addWords)
+    #   * [Working with custom
+    #   words](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
+    #   * [Validating a words
+    #   resource](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel).
     # @param customization_id [String] 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.
@@ -1971,7 +2087,7 @@ module IBMWatson
     #   not include spaces in the word. Use a `-` (dash) or `_` (underscore) to connect
     #   the tokens of compound words. URL-encode the word if it includes non-ASCII
     #   characters. For more information, see [Character
-    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
     # @param word [String] For the **Add custom words** method, you must specify the custom word that is to
     #   be added to or updated in the custom model. Do not include spaces in the word. Use
     #   a `-` (dash) or `_` (underscore) to connect the tokens of compound words.
@@ -2029,13 +2145,13 @@ module IBMWatson
     #   about its words.
     #
     #   **See also:** [Listing words from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageWords#listWords).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageWords#listWords).
     # @param customization_id [String] 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.
     # @param word_name [String] The custom word that is to be read from the custom language model. URL-encode the
     #   word if it includes non-ASCII characters. For more information, see [Character
-    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_word(customization_id:, word_name:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -2070,13 +2186,13 @@ module IBMWatson
     #   instance of the service that owns a model to delete its words.
     #
     #   **See also:** [Deleting a word from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageWords#deleteWord).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageWords#deleteWord).
     # @param customization_id [String] 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.
     # @param word_name [String] The custom word that is to be deleted from the custom language model. URL-encode
     #   the word if it includes non-ASCII characters. For more information, see [Character
-    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
     # @return [nil]
     def delete_word(customization_id:, word_name:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -2111,7 +2227,7 @@ module IBMWatson
     #   model to list its grammars.
     #
     #   **See also:** [Listing grammars from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
     # @param customization_id [String] 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.
@@ -2147,12 +2263,12 @@ module IBMWatson
     #
     #   The call returns an HTTP 201 response code if the grammar is valid. The service
     #   then asynchronously processes the contents of the grammar and automatically
-    #   extracts new words that it finds. This can take a few seconds to complete
-    #   depending on the size and complexity of the grammar, as well as the current load
-    #   on the service. You cannot submit requests to add additional resources to the
-    #   custom model or to train the model until the service's analysis of the grammar for
-    #   the current request completes. Use the **Get a grammar** method to check the
-    #   status of the analysis.
+    #   extracts new words that it finds. This operation can take a few seconds or minutes
+    #   to complete depending on the size and complexity of the grammar, as well as the
+    #   current load on the service. You cannot submit requests to add additional
+    #   resources to the custom model or to train the model until the service's analysis
+    #   of the grammar for the current request completes. Use the **Get a grammar** method
+    #   to check the status of the analysis.
     #
     #   The service populates the model's words resource with any word that is recognized
     #   by the grammar that is not found in the model's base vocabulary. These are
@@ -2175,9 +2291,9 @@ module IBMWatson
     #
     #   **See also:**
     #   * [Understanding
-    #   grammars](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-grammarUnderstand#grammarUnderstand)
+    #   grammars](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-grammarUnderstand#grammarUnderstand)
     #   * [Add a grammar to the custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-grammarAdd#addGrammar).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-grammarAdd#addGrammar).
     # @param customization_id [String] 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.
@@ -2257,7 +2373,7 @@ module IBMWatson
     #   model to list its grammars.
     #
     #   **See also:** [Listing grammars from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
     # @param customization_id [String] 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.
@@ -2296,7 +2412,7 @@ module IBMWatson
     #   for the instance of the service that owns a model to delete its grammar.
     #
     #   **See also:** [Deleting a grammar from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageGrammars#deleteGrammar).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#deleteGrammar).
     # @param customization_id [String] 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.
@@ -2340,7 +2456,7 @@ module IBMWatson
     #   below the limit.
     #
     #   **See also:** [Create a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-acoustic#createModel-acoustic).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acoustic#createModel-acoustic).
     # @param name [String] A user-defined name for the new custom acoustic model. Use a name that is unique
     #   among all custom acoustic models that you own. Use a localized name that matches
     #   the language of the custom model. Use a name that describes the acoustic
@@ -2352,7 +2468,7 @@ module IBMWatson
     #
     #   To determine whether a base model supports acoustic model customization, refer to
     #   [Language support for
-    #   customization](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-customization#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
     # @param description [String] A description of the new custom acoustic model. Use a localized description that
     #   matches the language of the custom model.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
@@ -2394,10 +2510,12 @@ module IBMWatson
     #   a model to list information about it.
     #
     #   **See also:** [Listing custom acoustic
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAcousticModels#listModels-acoustic).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAcousticModels#listModels-acoustic).
     # @param language [String] The identifier of the language for which custom language or custom acoustic models
-    #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
-    #   language or custom acoustic models that are owned by the requesting credentials.
+    #   are to be returned. Omit the parameter to see all custom language or custom
+    #   acoustic models that are owned by the requesting credentials. **Note:** The
+    #   `ar-AR` (Modern Standard Arabic) and `zh-CN` (Mandarin Chinese) languages are not
+    #   available for language model customization.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_acoustic_models(language: nil)
       headers = {
@@ -2428,7 +2546,7 @@ module IBMWatson
     #   for the instance of the service that owns a model to list information about it.
     #
     #   **See also:** [Listing custom acoustic
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAcousticModels#listModels-acoustic).
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAcousticModels#listModels-acoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic 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.
@@ -2461,7 +2579,7 @@ module IBMWatson
     #   model to delete it.
     #
     #   **See also:** [Deleting a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAcousticModels#deleteModel-acoustic).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAcousticModels#deleteModel-acoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic 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.
@@ -2499,7 +2617,7 @@ module IBMWatson
     #   to complete depending on the total amount of audio data on which the custom
     #   acoustic model is being trained and the current load on the service. Typically,
     #   training a custom acoustic model takes approximately two to four times the length
-    #   of its audio data. The range of time depends on the model being trained and the
+    #   of its audio data. The actual time depends on the model being trained and the
     #   nature of the audio, such as whether the audio is clean or noisy. The method
     #   returns an HTTP 200 response code to indicate that the training process has begun.
     #
@@ -2518,14 +2636,15 @@ module IBMWatson
     #   Train with a custom language model if you have verbatim transcriptions of the
     #   audio files that you have added to the custom model or you have either corpora
     #   (text files) or a list of words that are relevant to the contents of the audio
-    #   files. Both of the custom models must be based on the same version of the same
-    #   base model for training to succeed.
+    #   files. For training to succeed, both of the custom models must be based on the
+    #   same version of the same base model, and the custom language model must be fully
+    #   trained and available.
     #
     #   **See also:**
     #   * [Train the custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-acoustic#trainModel-acoustic)
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acoustic#trainModel-acoustic)
     #   * [Using custom acoustic and custom language models
-    #   together](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-useBoth#useBoth)
+    #   together](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-useBoth#useBoth)
     #
     #
     #   ### Training failures
@@ -2535,6 +2654,9 @@ module IBMWatson
     #   another training request or a request to add audio resources to the model.
     #   * The custom model contains less than 10 minutes or more than 200 hours of audio
     #   data.
+    #   * You passed a custom language model with the `custom_language_model_id` query
+    #   parameter that is not in the available state. A custom language model must be
+    #   fully trained and available to be used to train a custom acoustic model.
     #   * You passed an incompatible custom language model with the
     #   `custom_language_model_id` query parameter. Both custom models must be based on
     #   the same version of the same base model.
@@ -2550,8 +2672,8 @@ module IBMWatson
     #   been trained with verbatim transcriptions of the audio resources or that contains
     #   words that are relevant to the contents of the audio resources. The custom
     #   language model must be based on the same version of the same base model as the
-    #   custom acoustic model. The credentials specified with the request must own both
-    #   custom models.
+    #   custom acoustic model, and the custom language model must be fully trained and
+    #   available. The credentials specified with the request must own both custom models.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def train_acoustic_model(customization_id:, custom_language_model_id: nil)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -2590,7 +2712,7 @@ module IBMWatson
     #   owns a model to reset it.
     #
     #   **See also:** [Resetting a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAcousticModels#resetModel-acoustic).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAcousticModels#resetModel-acoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic 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.
@@ -2643,20 +2765,21 @@ module IBMWatson
     #   acoustic model was not trained with a custom language model.
     #
     #   **See also:** [Upgrading a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-customUpgrade#upgradeAcoustic).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customUpgrade#upgradeAcoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic 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.
     # @param custom_language_model_id [String] If the custom acoustic model was trained with a custom language model, the
     #   customization ID (GUID) of that custom language model. The custom language model
-    #   must be upgraded before the custom acoustic model can be upgraded. The credentials
-    #   specified with the request must own both custom models.
+    #   must be upgraded before the custom acoustic model can be upgraded. The custom
+    #   language model must be fully trained and available. The credentials specified with
+    #   the request must own both custom models.
     # @param force [Boolean] If `true`, forces the upgrade of a custom acoustic model for which no input data
     #   has been modified since it was last trained. Use this parameter only to force the
     #   upgrade of a custom acoustic model that is trained with a custom language model,
     #   and only if you receive a 400 response code and the message `No input data
     #   modified since last training`. See [Upgrading a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-customUpgrade#upgradeAcoustic).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customUpgrade#upgradeAcoustic).
     # @return [nil]
     def upgrade_acoustic_model(customization_id:, custom_language_model_id: nil, force: nil)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -2697,7 +2820,7 @@ module IBMWatson
     #   the instance of the service that owns a model to list its audio resources.
     #
     #   **See also:** [Listing audio resources for a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAudio#listAudio).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAudio#listAudio).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic 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.
@@ -2745,14 +2868,14 @@ module IBMWatson
     #   same name as an existing audio resource, set the `allow_overwrite` parameter to
     #   `true`; otherwise, the request fails.
     #
-    #   The method is asynchronous. It can take several seconds to complete depending on
-    #   the duration of the audio and, in the case of an archive file, the total number of
-    #   audio files being processed. The service returns a 201 response code if the audio
-    #   is valid. It then asynchronously analyzes the contents of the audio file or files
-    #   and automatically extracts information about the audio such as its length,
-    #   sampling rate, and encoding. You cannot submit requests to train or upgrade the
-    #   model until the service's analysis of all audio resources for current requests
-    #   completes.
+    #   The method is asynchronous. It can take several seconds or minutes to complete
+    #   depending on the duration of the audio and, in the case of an archive file, the
+    #   total number of audio files being processed. The service returns a 201 response
+    #   code if the audio is valid. It then asynchronously analyzes the contents of the
+    #   audio file or files and automatically extracts information about the audio such as
+    #   its length, sampling rate, and encoding. You cannot submit requests to train or
+    #   upgrade the model until the service's analysis of all audio resources for current
+    #   requests completes.
     #
     #   To determine the status of the service's analysis of the audio, use the **Get an
     #   audio resource** method to poll the status of the audio. The method accepts the
@@ -2761,7 +2884,7 @@ module IBMWatson
     #   every few seconds until it becomes `ok`.
     #
     #   **See also:** [Add audio to the custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-acoustic#addAudio).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acoustic#addAudio).
     #
     #
     #   ### Content types for audio-type resources
@@ -2795,7 +2918,7 @@ module IBMWatson
     #   service labels the audio file as `invalid`.
     #
     #    **See also:** [Audio
-    #   formats](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
+    #   formats](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
     #
     #
     #   ### Content types for archive-type resources
@@ -2931,7 +3054,7 @@ module IBMWatson
     #   its audio resources.
     #
     #   **See also:** [Listing audio resources for a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAudio#listAudio).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAudio#listAudio).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic 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.
@@ -2972,7 +3095,7 @@ module IBMWatson
     #   service that owns a model to delete its audio resources.
     #
     #   **See also:** [Deleting an audio resource from a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAudio#deleteAudio).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAudio#deleteAudio).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic 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.
@@ -3009,13 +3132,18 @@ module IBMWatson
     #   deletes all data for the customer ID, regardless of the method by which the
     #   information was added. The method has no effect if no data is associated with the
     #   customer ID. You must issue the request with credentials for the same instance of
-    #   the service that was used to associate the customer ID with the data.
+    #   the service that was used to associate the customer ID with the data. You
+    #   associate a customer ID with data by passing the `X-Watson-Metadata` header with a
+    #   request that passes the data.
     #
-    #   You associate a customer ID with data by passing the `X-Watson-Metadata` header
-    #   with a request that passes the data.
+    #   **Note:** If you delete an instance of the service from the service console, all
+    #   data associated with that service instance is automatically deleted. This includes
+    #   all custom language models, corpora, grammars, and words; all custom acoustic
+    #   models and audio resources; all registered endpoints for the asynchronous HTTP
+    #   interface; and all data related to speech recognition requests.
     #
     #   **See also:** [Information
-    #   security](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-information-security#information-security).
+    #   security](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-information-security#information-security).
     # @param customer_id [String] The customer ID for which all data is to be deleted.
     # @return [nil]
     def delete_user_data(customer_id:)