ibm_watson 2.0.2 → 2.1.3

data/lib/ibm_watson/personality_insights_v3.rb

@@ -14,17 +14,20 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-# IBM OpenAPI SDK Code Generator Version: 3.19.0-be3b4618-20201113-200858
+# IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 #
-# IBM® will begin sunsetting IBM Watson™ Personality Insights on 1 December
-# 2020. For a period of one year from this date, you will still be able to use Watson
-# Personality Insights. However, as of 1 December 2021, the offering will no longer be
-# available.<br/><br/>As an alternative, we encourage you to consider migrating to IBM
-# Watson&trade; Natural Language Understanding, a service on IBM Cloud&reg; that uses deep
-# learning to extract data and insights from text such as keywords, categories, sentiment,
-# emotion, and syntax to provide insights for your business or industry. For more
-# information, see [About Natural Language
-# Understanding](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-about).
+# IBM Watson&trade; Personality Insights is discontinued. Existing instances are
+# supported until 1 December 2021, but as of 1 December 2020, you cannot create new
+# instances. Any instance that exists on 1 December 2021 will be deleted.<br/><br/>No
+# direct replacement exists for Personality Insights. However, you can consider using [IBM
+# Watson&trade; Natural Language
+# Understanding](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-about)
+# on IBM Cloud&reg; as part of a replacement analytic workflow for your Personality
+# Insights use cases. You can use Natural Language Understanding to extract data and
+# insights from text, such as keywords, categories, sentiment, emotion, and syntax. For
+# more information about the personality models in Personality Insights, see [The science
+# behind the
+# service](https://cloud.ibm.com/docs/personality-insights?topic=personality-insights-science).
 # {: deprecated}
 #
 # The IBM Watson Personality Insights service enables applications to derive insights from
@@ -54,7 +57,6 @@ require "json"
 require "ibm_cloud_sdk_core"
 require_relative "./common.rb"
 
-# Module for the Watson APIs
 module IBMWatson
   ##
   # The Personality Insights V3 service.

data/lib/ibm_watson/speech_to_text_v1.rb

@@ -14,14 +14,20 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-# IBM OpenAPI SDK Code Generator Version: 3.19.0-be3b4618-20201113-200858
+# IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
 #
 # 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.
+# of the audio. It returns all JSON response content in the UTF-8 character set.
+#
+# The service supports two types of models: previous-generation models that include the
+# terms `Broadband` and `Narrowband` in their names, and next-generation models that
+# include the terms `Multimedia` and `Telephony` in their names. Broadband and multimedia
+# models have minimum sampling rates of 16 kHz. Narrowband and telephony models have
+# minimum sampling rates of 8 kHz. The next-generation models offer high throughput and
+# greater transcription accuracy.
 #
 # For speech recognition, the service supports synchronous and asynchronous HTTP
 # Representational State Transfer (REST) interfaces. It also supports a WebSocket
@@ -36,9 +42,10 @@
 # is a formal language specification that lets you restrict the phrases that the service
 # can recognize.
 #
-# 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.
+# Language model customization is available for most previous- and next-generation models.
+# Acoustic model customization is available for all previous-generation models. Grammars
+# are beta functionality that is available for all previous-generation models that support
+# language model customization.
 
 require "concurrent"
 require "erb"
@@ -46,7 +53,6 @@ require "json"
 require "ibm_cloud_sdk_core"
 require_relative "./common.rb"
 
-# Module for the Watson APIs
 module IBMWatson
   ##
   # The Speech to Text V1 service.
@@ -89,8 +95,8 @@ module IBMWatson
     #   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/speech-to-text?topic=speech-to-text-models#models).
+    #   **See also:** [Listing
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-list).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_models
       headers = {
@@ -116,10 +122,11 @@ module IBMWatson
     #   with the service. The information includes the name of the model and its minimum
     #   sampling rate in Hertz, among other things.
     #
-    #   **See also:** [Languages and
-    #   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.
+    #   **See also:** [Listing
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-list).
+    # @param model_id [String] The identifier of the model in the form of its name from the output of the [List
+    #   models](#listmodels) method. (**Note:** The model `ar-AR_BroadbandModel` is
+    #   deprecated; use `ar-MS_BroadbandModel` instead.).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_model(model_id:)
       raise ArgumentError.new("model_id must be provided") if model_id.nil?
@@ -144,7 +151,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, speech_detector_sensitivity: nil, background_audio_suppression: 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, low_latency: 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
@@ -211,8 +218,31 @@ module IBMWatson
     #   sampling rate of the audio is lower than the minimum required rate, the request
     #   fails.
     #
-    #    **See also:** [Audio
-    #   formats](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
+    #    **See also:** [Supported audio
+    #   formats](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-audio-formats).
+    #
+    #
+    #   ### Next-generation models
+    #
+    #    The service supports next-generation `Multimedia` (16 kHz) and `Telephony` (8
+    #   kHz) models for many languages. Next-generation models have higher throughput than
+    #   the service's previous generation of `Broadband` and `Narrowband` models. When you
+    #   use next-generation models, the service can return transcriptions more quickly and
+    #   also provide noticeably better transcription accuracy.
+    #
+    #   You specify a next-generation model by using the `model` query parameter, as you
+    #   do a previous-generation model. Many next-generation models also support the
+    #   `low_latency` parameter, which is not available with previous-generation models.
+    #
+    #   But next-generation models do not support all of the parameters that are available
+    #   for use with previous-generation models. For more information about all parameters
+    #   that are supported for use with next-generation models, see [Supported features
+    #   for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-features).
+    #
+    #
+    #   **See also:** [Next-generation languages and
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng).
     #
     #
     #   ### Multipart speech recognition
@@ -235,15 +265,19 @@ module IBMWatson
     # @param audio [File] 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/speech-to-text?topic=speech-to-text-models#models).
+    # @param model [String] The identifier of the model that is to be used for the recognition request.
+    #   (**Note:** The model `ar-AR_BroadbandModel` is deprecated; use
+    #   `ar-MS_BroadbandModel` instead.) See [Previous-generation languages and
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models) and
+    #   [Next-generation languages and
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng).
     # @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/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   default, no custom language model is used. See [Using a custom language model for
+    #   speech
+    #   recognition](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageUse).
     #
     #
     #   **Note:** Use this parameter instead of the deprecated `customization_id`
@@ -252,14 +286,16 @@ module IBMWatson
     #   recognition 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 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/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   default, no custom acoustic model is used. See [Using a custom acoustic model for
+    #   speech
+    #   recognition](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acousticUse).
     # @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/speech-to-text?topic=speech-to-text-input#version).
+    #   whether the parameter is used with or without a custom model. See [Making speech
+    #   recognition requests with upgraded custom
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-upgrade-use#custom-upgrade-use-recognition).
     # @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
@@ -276,8 +312,8 @@ module IBMWatson
     #   custom model's domain, but it can negatively affect performance on non-domain
     #   phrases.
     #
-    #   See [Custom
-    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   See [Using customization
+    #   weight](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageUse#weight).
     # @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
@@ -294,56 +330,61 @@ module IBMWatson
     #   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).
+    #   spotting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-spotting#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/speech-to-text?topic=speech-to-text-output#keyword_spotting).
+    #   spotting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-spotting#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/speech-to-text?topic=speech-to-text-output#max_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metadata#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/speech-to-text?topic=speech-to-text-output#word_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-spotting#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/speech-to-text?topic=speech-to-text-output#word_confidence).
+    #   confidence](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metadata#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/speech-to-text?topic=speech-to-text-output#word_timestamps).
+    #   timestamps](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metadata#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/speech-to-text?topic=speech-to-text-output#profanity_filter).
+    #   and Japanese transcription only. See [Profanity
+    #   filtering](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-formatting#profanity-filtering).
     # @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,
     #   the service also converts certain keyword strings to punctuation symbols. By
     #   default, the service performs no smart formatting.
     #
-    #   **Note:** Applies to US English, Japanese, and Spanish transcription only.
+    #   **Beta:** The parameter is beta functionality. Applies to US English, Japanese,
+    #   and Spanish transcription only.
     #
     #   See [Smart
-    #   formatting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#smart_formatting).
+    #   formatting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-formatting#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, Australian English, German, Japanese, Korean, and
-    #   Spanish (both broadband and narrowband models) and UK English (narrowband model)
-    #   transcription only.
+    #   **Beta:** The parameter is beta functionality.
+    #   * For previous-generation models, the parameter can be used for Australian
+    #   English, US English, German, Japanese, Korean, and Spanish (both broadband and
+    #   narrowband models) and UK English (narrowband model) transcription only.
+    #   * For next-generation models, the parameter can be used for English (Australian,
+    #   Indian, UK, and US), German, Japanese, Korean, and Spanish transcription only.
     #
-    #   See [Speaker
-    #   labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#speaker_labels).
+    #   Restrictions and limitations apply to the use of speaker labels for both types of
+    #   models. See [Speaker
+    #   labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-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.
@@ -351,8 +392,12 @@ module IBMWatson
     #   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/speech-to-text?topic=speech-to-text-input#grammars-input).
+    #   it does not recognize other custom words from the model's words resource.
+    #
+    #   **Beta:** The parameter is beta functionality.
+    #
+    #   See [Using a grammar for speech
+    #   recognition](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-grammarUse).
     # @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,
@@ -364,16 +409,17 @@ module IBMWatson
     #   `keywords_threshold` parameters) and returns only a single final transcript
     #   (forces the `max_alternatives` parameter to be `1`).
     #
-    #   **Note:** Applies to US English, Japanese, and Korean transcription only.
+    #   **Beta:** The parameter is beta functionality. Applies to US English, Japanese,
+    #   and Korean transcription only.
     #
     #   See [Numeric
-    #   redaction](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#redaction).
+    #   redaction](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-formatting#numeric-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/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
@@ -390,7 +436,7 @@ module IBMWatson
     #   Chinese is 0.6 seconds.
     #
     #   See [End of phrase silence
-    #   time](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#silence_time).
+    #   time](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-parsing#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
@@ -400,7 +446,7 @@ module IBMWatson
     #   interval.
     #
     #   See [Split transcript at phrase
-    #   end](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#split_transcript).
+    #   end](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-parsing#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
@@ -412,8 +458,8 @@ module IBMWatson
     #   * 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).
+    #   The values increase on a monotonic curve. See [Speech detector
+    #   sensitivity](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-detection#detection-parameters-sensitivity).
     # @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.
@@ -424,10 +470,24 @@ module IBMWatson
     #   * 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).
+    #   The values increase on a monotonic curve. See [Background audio
+    #   suppression](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-detection#detection-parameters-suppression).
+    # @param low_latency [Boolean] If `true` for next-generation `Multimedia` and `Telephony` models that support low
+    #   latency, directs the service to produce results even more quickly than it usually
+    #   does. Next-generation models produce transcription results faster than
+    #   previous-generation models. The `low_latency` parameter causes the models to
+    #   produce results even more quickly, though the results might be less accurate when
+    #   the parameter is used.
+    #
+    #   The parameter is not available for previous-generation `Broadband` and
+    #   `Narrowband` models. It is available only for some next-generation models. For a
+    #   list of next-generation models that support low latency, see [Supported
+    #   next-generation language
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-supported).
+    #   * For more information about the `low_latency` parameter, see [Low
+    #   latency](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-interim#low-latency).
     # @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, speech_detector_sensitivity: nil, background_audio_suppression: 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, low_latency: nil)
       raise ArgumentError.new("audio must be provided") if audio.nil?
 
       headers = {
@@ -460,7 +520,8 @@ module IBMWatson
         "end_of_phrase_silence_time" => end_of_phrase_silence_time,
         "split_transcript_at_phrase_end" => split_transcript_at_phrase_end,
         "speech_detector_sensitivity" => speech_detector_sensitivity,
-        "background_audio_suppression" => background_audio_suppression
+        "background_audio_suppression" => background_audio_suppression,
+        "low_latency" => low_latency
       }
 
       data = audio
@@ -479,7 +540,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, speech_detector_sensitivity: nil, background_audio_suppression: 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, low_latency: 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.
@@ -596,6 +657,23 @@ module IBMWatson
     #
     #   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 low_latency [Boolean] If `true` for next-generation `Multimedia` and `Telephony` models that support low
+    #   latency, directs the service to produce results even more quickly than it usually
+    #   does. Next-generation models produce transcription results faster than
+    #   previous-generation models. The `low_latency` parameter causes the models to
+    #   produce results even more quickly, though the results might be less accurate when
+    #   the parameter is used.
+    #
+    #   **Note:** The parameter is beta functionality. It is not available for
+    #   previous-generation `Broadband` and `Narrowband` models. It is available only for
+    #   some next-generation models.
+    #
+    #   * For a list of next-generation models that support low latency, see [Supported
+    #   language
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-supported)
+    #   for next-generation models.
+    #   * For more information about the `low_latency` parameter, see [Low
+    #   latency](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-interim#low-latency).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def recognize_using_websocket(
       content_type: nil,
@@ -627,7 +705,8 @@ module IBMWatson
       end_of_phrase_silence_time: nil,
       split_transcript_at_phrase_end: nil,
       speech_detector_sensitivity: nil,
-      background_audio_suppression: nil
+      background_audio_suppression: nil,
+      low_latency: nil
     )
       raise ArgumentError("Audio must be provided") if audio.nil? && !chunk_data
       raise ArgumentError("Recognize callback must be provided") if recognize_callback.nil?
@@ -669,7 +748,8 @@ module IBMWatson
         "end_of_phrase_silence_time" => end_of_phrase_silence_time,
         "split_transcript_at_phrase_end" => split_transcript_at_phrase_end,
         "speech_detector_sensitivity" => speech_detector_sensitivity,
-        "background_audio_suppression" => background_audio_suppression
+        "background_audio_suppression" => background_audio_suppression,
+        "low_latency" => low_latency
       }
       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)
@@ -697,9 +777,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 allowlist
-    #   the URL; it instead sends status code 400 in response to the **Register a
-    #   callback** request. If the requested callback URL is already allowlisted, the
-    #   service responds to the initial registration request with response code 200.
+    #   the URL; it instead sends status code 400 in response to the request to register a
+    #   callback. 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
     #   calculate an HMAC-SHA1 signature of the challenge string in its response to the
@@ -754,9 +834,10 @@ module IBMWatson
     ##
     # @!method unregister_callback(callback_url:)
     # Unregister a callback.
-    # 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.
+    # Unregisters a callback URL that was previously allowlisted with a [Register a
+    #   callback](#registercallback) 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/speech-to-text?topic=speech-to-text-async#unregister).
@@ -787,7 +868,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, speech_detector_sensitivity: nil, background_audio_suppression: 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, low_latency: 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
@@ -799,17 +880,17 @@ module IBMWatson
     #   to subscribe to specific events and to specify a string that is to be included
     #   with each notification for the job.
     #   * By polling the service: Omit the `callback_url`, `events`, and `user_token`
-    #   parameters. You must then use the **Check jobs** or **Check a job** methods to
-    #   check the status of the job, using the latter to retrieve the results when the job
-    #   is complete.
+    #   parameters. You must then use the [Check jobs](#checkjobs) or [Check a
+    #   job](#checkjob) methods to check the status of the job, using the latter to
+    #   retrieve the results when the job is complete.
     #
     #   The two approaches are not mutually exclusive. You can poll the service for job
     #   status or obtain results from the service manually even if you include a callback
     #   URL. In both cases, you can include the `results_ttl` parameter to specify how
     #   long the results are to remain available after the job is complete. Using the
-    #   HTTPS **Check a job** method to retrieve results is more secure than receiving
-    #   them via callback notification over HTTP because it provides confidentiality in
-    #   addition to authentication and data integrity.
+    #   HTTPS [Check a job](#checkjob) method to retrieve results is more secure than
+    #   receiving them via callback notification over HTTP because it provides
+    #   confidentiality in addition to authentication and data integrity.
     #
     #   The method supports the same basic parameters as other HTTP and WebSocket
     #   recognition requests. It also supports the following parameters specific to the
@@ -883,18 +964,44 @@ module IBMWatson
     #   sampling rate of the audio is lower than the minimum required rate, the request
     #   fails.
     #
-    #    **See also:** [Audio
-    #   formats](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
+    #    **See also:** [Supported audio
+    #   formats](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-audio-formats).
+    #
+    #
+    #   ### Next-generation models
+    #
+    #    The service supports next-generation `Multimedia` (16 kHz) and `Telephony` (8
+    #   kHz) models for many languages. Next-generation models have higher throughput than
+    #   the service's previous generation of `Broadband` and `Narrowband` models. When you
+    #   use next-generation models, the service can return transcriptions more quickly and
+    #   also provide noticeably better transcription accuracy.
+    #
+    #   You specify a next-generation model by using the `model` query parameter, as you
+    #   do a previous-generation model. Many next-generation models also support the
+    #   `low_latency` parameter, which is not available with previous-generation models.
+    #
+    #   But next-generation models do not support all of the parameters that are available
+    #   for use with previous-generation models. For more information about all parameters
+    #   that are supported for use with next-generation models, see [Supported features
+    #   for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-features).
+    #
+    #
+    #   **See also:** [Next-generation languages and
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng).
     # @param audio [File] 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/speech-to-text?topic=speech-to-text-models#models).
+    # @param model [String] The identifier of the model that is to be used for the recognition request.
+    #   (**Note:** The model `ar-AR_BroadbandModel` is deprecated; use
+    #   `ar-MS_BroadbandModel` instead.) See [Previous-generation languages and
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models) and
+    #   [Next-generation languages and
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng).
     # @param callback_url [String] A URL to which callback notifications are to be sent. The URL must already be
-    #   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.
+    #   successfully allowlisted by using the [Register a callback](#registercallback)
+    #   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.
     #
     #   Use the `user_token` parameter to specify a unique user-specified string with each
     #   job to differentiate the callback notifications for the jobs.
@@ -903,8 +1010,8 @@ module IBMWatson
     #   * `recognitions.started` generates a callback notification when the service begins
     #   to process the job.
     #   * `recognitions.completed` generates a callback notification when the job is
-    #   complete. You must use the **Check a job** method to retrieve the results before
-    #   they time out or are deleted.
+    #   complete. You must use the [Check a job](#checkjob) method to retrieve the results
+    #   before they time out or are deleted.
     #   * `recognitions.completed_with_results` generates a callback notification when the
     #   job is complete. The notification includes the results of the request.
     #   * `recognitions.failed` generates a callback notification if the service
@@ -929,8 +1036,9 @@ module IBMWatson
     #   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/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   default, no custom language model is used. See [Using a custom language model for
+    #   speech
+    #   recognition](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageUse).
     #
     #
     #   **Note:** Use this parameter instead of the deprecated `customization_id`
@@ -939,14 +1047,16 @@ module IBMWatson
     #   recognition 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 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/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   default, no custom acoustic model is used. See [Using a custom acoustic model for
+    #   speech
+    #   recognition](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acousticUse).
     # @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/speech-to-text?topic=speech-to-text-input#version).
+    #   whether the parameter is used with or without a custom model. See [Making speech
+    #   recognition requests with upgraded custom
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-upgrade-use#custom-upgrade-use-recognition).
     # @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
@@ -963,8 +1073,8 @@ module IBMWatson
     #   custom model's domain, but it can negatively affect performance on non-domain
     #   phrases.
     #
-    #   See [Custom
-    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#custom-input).
+    #   See [Using customization
+    #   weight](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageUse#weight).
     # @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
@@ -981,56 +1091,61 @@ module IBMWatson
     #   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).
+    #   spotting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-spotting#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/speech-to-text?topic=speech-to-text-output#keyword_spotting).
+    #   spotting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-spotting#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/speech-to-text?topic=speech-to-text-output#max_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metadata#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/speech-to-text?topic=speech-to-text-output#word_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-spotting#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/speech-to-text?topic=speech-to-text-output#word_confidence).
+    #   confidence](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metadata#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/speech-to-text?topic=speech-to-text-output#word_timestamps).
+    #   timestamps](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metadata#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/speech-to-text?topic=speech-to-text-output#profanity_filter).
+    #   and Japanese transcription only. See [Profanity
+    #   filtering](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-formatting#profanity-filtering).
     # @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,
     #   the service also converts certain keyword strings to punctuation symbols. By
     #   default, the service performs no smart formatting.
     #
-    #   **Note:** Applies to US English, Japanese, and Spanish transcription only.
+    #   **Beta:** The parameter is beta functionality. Applies to US English, Japanese,
+    #   and Spanish transcription only.
     #
     #   See [Smart
-    #   formatting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#smart_formatting).
+    #   formatting](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-formatting#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, Australian English, German, Japanese, Korean, and
-    #   Spanish (both broadband and narrowband models) and UK English (narrowband model)
-    #   transcription only.
+    #   **Beta:** The parameter is beta functionality.
+    #   * For previous-generation models, the parameter can be used for Australian
+    #   English, US English, German, Japanese, Korean, and Spanish (both broadband and
+    #   narrowband models) and UK English (narrowband model) transcription only.
+    #   * For next-generation models, the parameter can be used for English (Australian,
+    #   Indian, UK, and US), German, Japanese, Korean, and Spanish transcription only.
     #
-    #   See [Speaker
-    #   labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#speaker_labels).
+    #   Restrictions and limitations apply to the use of speaker labels for both types of
+    #   models. See [Speaker
+    #   labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-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.
@@ -1038,8 +1153,12 @@ module IBMWatson
     #   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/speech-to-text?topic=speech-to-text-input#grammars-input).
+    #   it does not recognize other custom words from the model's words resource.
+    #
+    #   **Beta:** The parameter is beta functionality.
+    #
+    #   See [Using a grammar for speech
+    #   recognition](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-grammarUse).
     # @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,
@@ -1051,10 +1170,11 @@ module IBMWatson
     #   `keywords_threshold` parameters) and returns only a single final transcript
     #   (forces the `max_alternatives` parameter to be `1`).
     #
-    #   **Note:** Applies to US English, Japanese, and Korean transcription only.
+    #   **Beta:** The parameter is beta functionality. Applies to US English, Japanese,
+    #   and Korean transcription only.
     #
     #   See [Numeric
-    #   redaction](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#redaction).
+    #   redaction](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-formatting#numeric-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
@@ -1062,7 +1182,7 @@ module IBMWatson
     #   the service returns no processing metrics.
     #
     #   See [Processing
-    #   metrics](https://cloud.ibm.com/docs/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`.
@@ -1076,13 +1196,13 @@ module IBMWatson
     #   the service returns processing metrics only for transcription events.
     #
     #   See [Processing
-    #   metrics](https://cloud.ibm.com/docs/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/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
@@ -1099,7 +1219,7 @@ module IBMWatson
     #   Chinese is 0.6 seconds.
     #
     #   See [End of phrase silence
-    #   time](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#silence_time).
+    #   time](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-parsing#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
@@ -1109,7 +1229,7 @@ module IBMWatson
     #   interval.
     #
     #   See [Split transcript at phrase
-    #   end](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#split_transcript).
+    #   end](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-parsing#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
@@ -1121,8 +1241,8 @@ module IBMWatson
     #   * 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).
+    #   The values increase on a monotonic curve. See [Speech detector
+    #   sensitivity](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-detection#detection-parameters-sensitivity).
     # @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.
@@ -1133,10 +1253,24 @@ module IBMWatson
     #   * 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).
+    #   The values increase on a monotonic curve. See [Background audio
+    #   suppression](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-detection#detection-parameters-suppression).
+    # @param low_latency [Boolean] If `true` for next-generation `Multimedia` and `Telephony` models that support low
+    #   latency, directs the service to produce results even more quickly than it usually
+    #   does. Next-generation models produce transcription results faster than
+    #   previous-generation models. The `low_latency` parameter causes the models to
+    #   produce results even more quickly, though the results might be less accurate when
+    #   the parameter is used.
+    #
+    #   The parameter is not available for previous-generation `Broadband` and
+    #   `Narrowband` models. It is available only for some next-generation models. For a
+    #   list of next-generation models that support low latency, see [Supported
+    #   next-generation language
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-ng#models-ng-supported).
+    #   * For more information about the `low_latency` parameter, see [Low
+    #   latency](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-interim#low-latency).
     # @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, speech_detector_sensitivity: nil, background_audio_suppression: 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, low_latency: nil)
       raise ArgumentError.new("audio must be provided") if audio.nil?
 
       headers = {
@@ -1175,7 +1309,8 @@ module IBMWatson
         "end_of_phrase_silence_time" => end_of_phrase_silence_time,
         "split_transcript_at_phrase_end" => split_transcript_at_phrase_end,
         "speech_detector_sensitivity" => speech_detector_sensitivity,
-        "background_audio_suppression" => background_audio_suppression
+        "background_audio_suppression" => background_audio_suppression,
+        "low_latency" => low_latency
       }
 
       data = audio
@@ -1200,10 +1335,10 @@ module IBMWatson
     #   credentials with which it is called. The method also returns the creation and
     #   update times of each job, and, if a job was created with a callback URL and a user
     #   token, the user token for the job. To obtain the results for a job whose status is
-    #   `completed` or not one of the latest 100 outstanding jobs, use the **Check a job**
-    #   method. A job and its results remain available until you delete them with the
-    #   **Delete a job** method or until the job's time to live expires, whichever comes
-    #   first.
+    #   `completed` or not one of the latest 100 outstanding jobs, use the [Check a
+    #   job[(#checkjob) method. A job and its results remain available until you delete
+    #   them with the [Delete a job](#deletejob) method or until the job's time to live
+    #   expires, whichever comes first.
     #
     #   **See also:** [Checking the status of the latest
     #   jobs](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#jobs).
@@ -1237,8 +1372,8 @@ module IBMWatson
     #   You can use the method to retrieve the results of any job, regardless of whether
     #   it was submitted with a callback URL and the `recognitions.completed_with_results`
     #   event, and you can retrieve the results multiple times for as long as they remain
-    #   available. Use the **Check jobs** method to request information about the most
-    #   recent jobs associated with the calling credentials.
+    #   available. Use the [Check jobs](#checkjobs) method to request information about
+    #   the most recent jobs associated with the calling credentials.
     #
     #   **See also:** [Checking the status and retrieving the results of a
     #   job](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#job).
@@ -1326,28 +1461,28 @@ module IBMWatson
     #   customizes.
     #
     #   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/speech-to-text?topic=speech-to-text-customization#languageSupport).
+    #   [Get a model](#getmodel) 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/speech-to-text?topic=speech-to-text-custom-support#custom-language-support).
     # @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
-    #   models.
+    #   default. For example, `en-US` is used for the US English language models. All
+    #   dialect values are case-insensitive.
     #
-    #   For a Spanish language, the service creates a custom language model that is suited
-    #   for speech in one of the following dialects:
+    #   The parameter is meaningful only for Spanish language models, for which you can
+    #   always safely omit the parameter to have the service create the correct mapping.
+    #   For Spanish, the service creates a custom language model that is suited for speech
+    #   in one of the following dialects:
     #   * `es-ES` for Castilian Spanish (`es-ES` models)
     #   * `es-LA` for Latin American Spanish (`es-AR`, `es-CL`, `es-CO`, and `es-PE`
     #   models)
     #   * `es-US` for Mexican (North American) Spanish (`es-MX` models)
     #
-    #   The parameter is meaningful only for Spanish models, for which you can always
-    #   safely omit the parameter to have the service create the correct mapping.
-    #
-    #   If you specify the `dialect` parameter for non-Spanish language models, its value
-    #   must match the language of the base model. If you specify the `dialect` for
-    #   Spanish language models, its value must match one of the defined mappings as
-    #   indicated (`es-ES`, `es-LA`, or `es-MX`). All dialect values are case-insensitive.
+    #   If you specify the `dialect` parameter for a non-Spanish language model, its value
+    #   must match the language of the base model. If you specify the `dialect` for a
+    #   Spanish language model, its value must match one of the defined mappings (`es-ES`,
+    #   `es-LA`, or `es-MX`).
     # @param description [String] A description of the new custom language model. Use a localized description that
     #   matches the language of the custom model.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
@@ -1393,11 +1528,12 @@ module IBMWatson
     #   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. Omit the parameter to see all custom language or custom
-    #   acoustic models that are owned by the requesting credentials.
+    #   acoustic models that are owned by the requesting credentials. (**Note:** The
+    #   identifier `ar-AR` is deprecated; use `ar-MS` instead.)
     #
     #   To determine the languages for which customization is available, see [Language
     #   support for
-    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support#custom-language-support).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_language_models(language: nil)
       headers = {
@@ -1501,12 +1637,13 @@ module IBMWatson
     #   the current load on the service. The method returns an HTTP 200 response code to
     #   indicate that the training process has begun.
     #
-    #   You can monitor the status of the training by using the **Get a custom language
-    #   model** method to poll the model's status. Use a loop to check the status every 10
-    #   seconds. The method returns a `LanguageModel` object that includes `status` and
-    #   `progress` fields. A status of `available` means that the custom model is trained
-    #   and ready to use. The service cannot accept subsequent training requests or
-    #   requests to add new resources until the existing request completes.
+    #   You can monitor the status of the training by using the [Get a custom language
+    #   model](#getlanguagemodel) method to poll the model's status. Use a loop to check
+    #   the status every 10 seconds. The method returns a `LanguageModel` object that
+    #   includes `status` and `progress` fields. A status of `available` means that the
+    #   custom model is trained and ready to use. The service cannot accept subsequent
+    #   training requests or requests to add new resources until the existing request
+    #   completes.
     #
     #   **See also:** [Train the custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#trainModel-language).
@@ -1526,14 +1663,18 @@ module IBMWatson
     # @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_type_to_add [String] The type of words from the custom language model's words resource on which to
-    #   train the model:
+    # @param word_type_to_add [String] _For custom models that are based on previous-generation models_, the type of
+    #   words from the custom language model's words resource on which to train the model:
     #   * `all` (the default) trains the model on all new words, regardless of whether
     #   they were extracted from corpora or grammars or were added or modified by the
     #   user.
-    #   * `user` trains the model only on new words that were added or modified by the
+    #   * `user` trains the model only on custom words that were added or modified by the
     #   user directly. The model is not trained on new words extracted from corpora or
     #   grammars.
+    #
+    #   _For custom models that are based on next-generation models_, the service ignores
+    #   the parameter. The words resource contains only custom words that the user adds or
+    #   modifies directly, so the parameter is unnecessary.
     # @param customization_weight [Float] Specifies a customization weight for the custom language model. The customization
     #   weight tells the service how much weight to give to words from the custom language
     #   model compared to those from the base model for speech recognition. Specify a
@@ -1548,6 +1689,9 @@ module IBMWatson
     #   The value that you assign is used for all recognition requests that use the model.
     #   You can override it for any recognition request by specifying a customization
     #   weight for that request.
+    #
+    #   See [Using customization
+    #   weight](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageUse#weight).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def train_language_model(customization_id:, word_type_to_add: nil, customization_weight: nil)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1621,15 +1765,19 @@ module IBMWatson
     #
     #   The method returns an HTTP 200 response code to indicate that the upgrade process
     #   has begun successfully. You can monitor the status of the upgrade by using the
-    #   **Get a custom language model** method to poll the model's status. The method
-    #   returns a `LanguageModel` object that includes `status` and `progress` fields. Use
-    #   a loop to check the status every 10 seconds. While it is being upgraded, the
-    #   custom model has the status `upgrading`. When the upgrade is complete, the model
-    #   resumes the status that it had prior to upgrade. The service cannot accept
-    #   subsequent requests for the model until the upgrade completes.
+    #   [Get a custom language model](#getlanguagemodel) method to poll the model's
+    #   status. The method returns a `LanguageModel` object that includes `status` and
+    #   `progress` fields. Use a loop to check the status every 10 seconds. While it is
+    #   being upgraded, the custom model has the status `upgrading`. When the upgrade is
+    #   complete, the model resumes the status that it had prior to upgrade. The service
+    #   cannot accept subsequent requests for the model until the upgrade completes.
+    #
+    #   **Note:** Upgrading is necessary only for custom language models that are based on
+    #   previous-generation models. Only a single version of a custom model that is based
+    #   on a next-generation model is ever available.
     #
     #   **See also:** [Upgrading a custom language
-    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customUpgrade#upgradeLanguage).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-upgrade#custom-upgrade-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.
@@ -1660,9 +1808,10 @@ module IBMWatson
     # @!method list_corpora(customization_id:)
     # List corpora.
     # Lists information about all corpora from a custom language model. The information
-    #   includes the total number of words and out-of-vocabulary (OOV) words, name, and
-    #   status of each corpus. You must use credentials for the instance of the service
-    #   that owns a model to list its corpora.
+    #   includes the name, status, and total number of words for each corpus. _For custom
+    #   models that are based on previous-generation models_, it also includes the number
+    #   of out-of-vocabulary (OOV) words from the corpus. You must use credentials for the
+    #   instance of the service that owns a model to list its corpora.
     #
     #   **See also:** [Listing corpora for a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageCorpora#listCorpora).
@@ -1696,51 +1845,60 @@ module IBMWatson
     #   Use multiple requests to submit multiple corpus text files. You must use
     #   credentials for the instance of the service that owns a model to add a corpus to
     #   it. Adding a corpus does not affect the custom language model until you train the
-    #   model for the new data by using the **Train a custom language model** method.
+    #   model for the new data by using the [Train a custom language
+    #   model](#trainlanguagemodel) method.
     #
     #   Submit a plain text file that contains sample sentences from the domain of
-    #   interest to enable the service to extract words in context. The more sentences you
-    #   add that represent the context in which speakers use words from the domain, the
-    #   better the service's recognition accuracy.
+    #   interest to enable the service to parse the words in context. The more sentences
+    #   you add that represent the context in which speakers use words from the domain,
+    #   the better the service's recognition accuracy.
     #
     #   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 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 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.
+    #   then asynchronously processes and automatically extracts data from the contents of
+    #   the corpus. This operation can take on the order of minutes to complete depending
+    #   on the current load on the service, the total number of words in the corpus, and,
+    #   _for custom models that are based on previous-generation models_, the number of
+    #   new (out-of-vocabulary) words in the corpus. 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 [Get a
+    #   corpus](#getcorpus) method to check the status of the analysis.
+    #
+    #   _For custom models that are based on previous-generation models_, the service
+    #   auto-populates the model's words resource with words from the corpus 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](#listwords) 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
     #   an existing corpus causes the service to process the corpus text file and extract
-    #   OOV words anew. Before doing so, it removes any OOV words associated with the
-    #   existing corpus from the model's words resource unless they were also added by
-    #   another corpus or grammar, or they have been modified in some way with the **Add
-    #   custom words** or **Add a custom word** method.
+    #   its data anew. _For a custom model that is based on a previous-generation model_,
+    #   the service first removes any OOV words that are associated with the existing
+    #   corpus from the model's words resource unless they were also added by another
+    #   corpus or grammar, or they have been modified in some way with the [Add custom
+    #   words](#addwords) or [Add a custom word](#addword) method.
     #
     #   The service limits the overall amount of data that you can add to a custom model
-    #   to a maximum of 10 million total words from all sources combined. Also, you can
-    #   add no more than 90 thousand custom (OOV) words to a model. This includes words
-    #   that the service extracts from corpora and grammars, and words that you add
-    #   directly.
+    #   to a maximum of 10 million total words from all sources combined. _For a custom
+    #   model that is based on a previous-generation model_, you can add no more than 90
+    #   thousand custom (OOV) words to a model. This includes words that the service
+    #   extracts from corpora and grammars, and words that you add directly.
     #
     #   **See also:**
     #   * [Add a corpus to the custom language
     #   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).
+    #   * [Working with corpora for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingCorpora)
+    #   * [Working with corpora for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#workingCorpora-ng)
+    #
+    #   * [Validating a words resource for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel)
+    #
+    #   * [Validating a words resource for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#validateModel-ng).
     # @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.
@@ -1763,10 +1921,10 @@ module IBMWatson
     #   in UTF-8 if it contains non-ASCII characters; the service assumes UTF-8 encoding
     #   if it encounters non-ASCII characters.
     #
-    #   Make sure that you know the character encoding of the file. You must use that
+    #   Make sure that you know the character encoding of the file. You must use that same
     #   encoding when working with the words in the custom language model. For more
-    #   information, see [Character
-    #   encoding](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
+    #   information, see [Character encoding for custom
+    #   words](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageWords#charEncoding).
     #
     #
     #   With the `curl` command, use the `--data-binary` option to upload the file for the
@@ -1815,9 +1973,10 @@ module IBMWatson
     # @!method get_corpus(customization_id:, corpus_name:)
     # Get a corpus.
     # Gets information about a corpus from a custom language model. The information
-    #   includes the total number of words and out-of-vocabulary (OOV) words, name, and
-    #   status of the corpus. You must use credentials for the instance of the service
-    #   that owns a model to list its corpora.
+    #   includes the name, status, and total number of words for the corpus. _For custom
+    #   models that are based on previous-generation models_, it also includes the number
+    #   of out-of-vocabulary (OOV) words from the corpus. You must use credentials for the
+    #   instance of the service that owns a model to list its corpora.
     #
     #   **See also:** [Listing corpora for a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageCorpora#listCorpora).
@@ -1850,14 +2009,18 @@ module IBMWatson
     ##
     # @!method delete_corpus(customization_id:, corpus_name:)
     # Delete a corpus.
-    # Deletes an existing corpus from a custom language model. The service removes any
-    #   out-of-vocabulary (OOV) words that are associated with the corpus from the custom
-    #   model's words resource unless they were also added by another corpus or grammar,
-    #   or they were modified in some way with the **Add custom words** or **Add a custom
-    #   word** method. Removing a corpus does not affect the custom model until you train
-    #   the model with the **Train a custom language model** method. You must use
-    #   credentials for the instance of the service that owns a model to delete its
-    #   corpora.
+    # Deletes an existing corpus from a custom language model. Removing a corpus does
+    #   not affect the custom model until you train the model with the [Train a custom
+    #   language model](#trainlanguagemodel) method. You must use credentials for the
+    #   instance of the service that owns a model to delete its corpora.
+    #
+    #   _For custom models that are based on previous-generation models_, the service
+    #   removes any out-of-vocabulary (OOV) words that are associated with the corpus from
+    #   the custom model's words resource unless they were also added by another corpus or
+    #   grammar, or they were modified in some way with the [Add custom words](#addwords)
+    #   or [Add a custom word](#addword) method.
+    #
+    #
     #
     #   **See also:** [Deleting a corpus from a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageCorpora#deleteCorpus).
@@ -1895,10 +2058,11 @@ module IBMWatson
     # List custom words.
     # Lists information about custom words from a custom language model. You can list
     #   all words from the custom model's words resource, only custom words that were
-    #   added or modified by the user, or only out-of-vocabulary (OOV) words that were
-    #   extracted from corpora or are recognized by grammars. You can also indicate the
-    #   order in which the service is to return words; by default, the service lists words
-    #   in ascending alphabetical order. You must use credentials for the instance of the
+    #   added or modified by the user, or, _for a custom model that is based on a
+    #   previous-generation model_, only out-of-vocabulary (OOV) words that were extracted
+    #   from corpora or are recognized by grammars. You can also indicate the order in
+    #   which the service is to return words; by default, the service lists words in
+    #   ascending alphabetical order. You must use credentials for the instance of the
     #   service that owns a model to list information about its words.
     #
     #   **See also:** [Listing words from a custom language
@@ -1911,6 +2075,10 @@ module IBMWatson
     #   * `user` shows only custom words that were added or modified by the user directly.
     #   * `corpora` shows only OOV that were extracted from corpora.
     #   * `grammars` shows only OOV words that are recognized by grammars.
+    #
+    #   _For a custom model that is based on a next-generation model_, only `all` and
+    #   `user` apply. Both options return the same results. Words from other sources are
+    #   not added to custom models that are based on next-generation models.
     # @param sort [String] Indicates the order in which the words are to be listed, `alphabetical` or by
     #   `count`. You can prepend an optional `+` or `-` to an argument to indicate whether
     #   the results are to be sorted in ascending or descending order. By default, words
@@ -1947,10 +2115,14 @@ module IBMWatson
     ##
     # @!method add_words(customization_id:, words:)
     # Add custom words.
-    # Adds one or more custom words to a custom language model. The service populates
+    # Adds one or more custom words to a custom language model. You can use this method
+    #   to add words or to modify existing words in a custom model's words resource. _For
+    #   custom models that are based on previous-generation models_, the service populates
     #   the words resource for a custom model with out-of-vocabulary (OOV) words from each
-    #   corpus or grammar that is added to the model. You can use this method to add
-    #   additional words or to modify existing words in the words resource. The words
+    #   corpus or grammar that is added to the model. You can use this method to modify
+    #   OOV words in the model's words resource.
+    #
+    #   _For a custom model that is based on a previous-generation model_, the words
     #   resource for a model can contain a maximum of 90 thousand custom (OOV) words. This
     #   includes words that the service extracts from corpora and grammars and words that
     #   you add directly.
@@ -1958,25 +2130,26 @@ module IBMWatson
     #   You must use credentials for the instance of the service that owns a model to add
     #   or modify custom words for the model. Adding or modifying custom words does not
     #   affect the custom model until you train the model for the new data by using the
-    #   **Train a custom language model** method.
+    #   [Train a custom language model](#trainlanguagemodel) method.
     #
     #   You add custom words by providing a `CustomWords` object, which is an array of
-    #   `CustomWord` objects, one per word. You must use the object's `word` parameter to
-    #   identify the word that is to be added. You can also provide one or both of the
-    #   optional `sounds_like` and `display_as` fields for each word.
-    #   * The `sounds_like` field provides an array of one or more pronunciations for the
-    #   word. Use the parameter to specify how the word can be pronounced by users. Use
-    #   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. 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.
+    #   `CustomWord` objects, one per word. Use the object's `word` parameter to identify
+    #   the word that is to be added. You can also provide one or both of the optional
+    #   `display_as` or `sounds_like` fields for each word.
     #   * 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
-    #   indicate that the word `IBM(trademark)` is to be displayed as `IBM™`.
+    #   indicate that the word `IBM` is to be displayed as `IBM™`.
+    #   * The `sounds_like` field, _which can be used only with a custom model that is
+    #   based on a previous-generation model_, provides an array of one or more
+    #   pronunciations for the word. Use the parameter to specify how the word can be
+    #   pronounced by users. Use 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. 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.
     #
     #   If you add a custom word that already exists in the words resource for the custom
     #   model, the new definition overwrites the existing data for the word. If the
@@ -1988,26 +2161,30 @@ module IBMWatson
     #   time that it takes for the analysis to complete depends on the number of new words
     #   that you add but is generally faster than adding a corpus or grammar.
     #
-    #   You can monitor the status of the request by using the **List a custom language
-    #   model** method to poll the model's status. Use a loop to check the status every 10
-    #   seconds. The method returns a `Customization` object that includes a `status`
-    #   field. A status of `ready` means that the words have been added to the custom
-    #   model. The service cannot accept requests to add new data or to train the model
-    #   until the existing request completes.
-    #
-    #   You can use the **List custom words** or **List a custom word** method to review
-    #   the words that you add. Words with an invalid `sounds_like` field include an
-    #   `error` field that describes the problem. You can use other words-related methods
-    #   to correct errors, eliminate typos, and modify how words are pronounced as needed.
+    #   You can monitor the status of the request by using the [Get a custom language
+    #   model](#getlanguagemodel) method to poll the model's status. Use a loop to check
+    #   the status every 10 seconds. The method returns a `Customization` object that
+    #   includes a `status` field. A status of `ready` means that the words have been
+    #   added to the custom model. The service cannot accept requests to add new data or
+    #   to train the model until the existing request completes.
     #
+    #   You can use the [List custom words](#listwords) or [Get a custom word](#getword)
+    #   method to review the words that you add. Words with an invalid `sounds_like` field
+    #   include an `error` field that describes the problem. You can use other
+    #   words-related methods to correct errors, eliminate typos, and modify how words are
+    #   pronounced as needed.
     #
     #   **See also:**
     #   * [Add words to the custom language
     #   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).
+    #   * [Working with custom words for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
+    #   * [Working with custom words for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#workingWords-ng)
+    #   * [Validating a words resource for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel)
+    #   * [Validating a words resource for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#validateModel-ng).
     # @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.
@@ -2043,47 +2220,57 @@ module IBMWatson
     ##
     # @!method add_word(customization_id:, word_name:, word: nil, sounds_like: nil, display_as: nil)
     # Add a custom word.
-    # Adds a custom word to a custom language model. The service populates the words
-    #   resource for a custom model with out-of-vocabulary (OOV) words from each corpus or
-    #   grammar that is added to the model. You can use this method to add a word or to
-    #   modify an existing word in the words resource. The words resource for a model can
-    #   contain a maximum of 90 thousand custom (OOV) words. This includes words that the
-    #   service extracts from corpora and grammars and words that you add directly.
+    # Adds a custom word to a custom language model. You can use this method to add a
+    #   word or to modify an existing word in the words resource. _For custom models that
+    #   are based on previous-generation models_, the service populates the words resource
+    #   for a custom model with out-of-vocabulary (OOV) words from each corpus or grammar
+    #   that is added to the model. You can use this method to modify OOV words in the
+    #   model's words resource.
+    #
+    #   _For a custom model that is based on a previous-generation models_, the words
+    #   resource for a model can contain a maximum of 90 thousand custom (OOV) words. This
+    #   includes words that the service extracts from corpora and grammars and words that
+    #   you add directly.
     #
     #   You must use credentials for the instance of the service that owns a model to add
     #   or modify a custom word for the model. Adding or modifying a custom word does not
     #   affect the custom model until you train the model for the new data by using the
-    #   **Train a custom language model** method.
+    #   [Train a custom language model](#trainlanguagemodel) method.
     #
     #   Use the `word_name` parameter to specify the custom word that is to be added or
     #   modified. Use the `CustomWord` object to provide one or both of the optional
-    #   `sounds_like` and `display_as` fields for the word.
-    #   * The `sounds_like` field provides an array of one or more pronunciations for the
-    #   word. Use the parameter to specify how the word can be pronounced by users. Use
-    #   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. 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.
+    #   `display_as` or `sounds_like` fields for the word.
     #   * 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
-    #   indicate that the word `IBM(trademark)` is to be displayed as `IBM™`.
+    #   indicate that the word `IBM` is to be displayed as `IBM™`.
+    #   * The `sounds_like` field, _which can be used only with a custom model that is
+    #   based on a previous-generation model_, provides an array of one or more
+    #   pronunciations for the word. Use the parameter to specify how the word can be
+    #   pronounced by users. Use 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. 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.
     #
     #   If you add a custom word that already exists in the words resource for the custom
     #   model, the new definition overwrites the existing data for the word. If the
     #   service encounters an error, it does not add the word to the words resource. Use
-    #   the **List a custom word** method to review the word that you add.
+    #   the [Get a custom word](#getword) method to review the word that you add.
     #
     #   **See also:**
     #   * [Add words to the custom language
     #   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).
+    #   * [Working with custom words for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
+    #   * [Working with custom words for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#workingWords-ng)
+    #   * [Validating a words resource for previous-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords#validateModel)
+    #   * [Validating a words resource for next-generation
+    #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-corporaWords-ng#validateModel-ng).
     # @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.
@@ -2092,14 +2279,16 @@ module IBMWatson
     #   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/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.
-    #
-    #   Omit this parameter for the **Add a custom word** method.
-    # @param sounds_like [Array[String]] An array of sounds-like pronunciations for the custom word. Specify how words that
-    #   are difficult to pronounce, foreign words, acronyms, and so on can be pronounced
-    #   by users.
+    # @param word [String] For the [Add custom words](#addwords) 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.
+    #
+    #   Omit this parameter for the [Add a custom word](#addword) method.
+    # @param sounds_like [Array[String]] _For a custom model that is based on a previous-generation model_, an array of
+    #   sounds-like pronunciations for the custom word. Specify how words that are
+    #   difficult to pronounce, foreign words, acronyms, and so on can be pronounced by
+    #   users.
     #   * For a word that is not in the service's base vocabulary, omit the parameter to
     #   have the service automatically generate a sounds-like pronunciation for the word.
     #   * For a word that is in the service's base vocabulary, use the parameter to
@@ -2109,6 +2298,10 @@ module IBMWatson
     #
     #   A word can have at most five sounds-like pronunciations. A pronunciation can
     #   include at most 40 characters not including spaces.
+    #
+    #   _For a custom model that is based on a next-generation model_, omit this field.
+    #   Custom models based on next-generation models do not support the `sounds_like`
+    #   field. The service ignores the field.
     # @param display_as [String] An alternative spelling for the custom word when it appears in a transcript. Use
     #   the parameter when you want the word to have a spelling that is different from its
     #   usual representation or from its spelling in corpora training data.
@@ -2183,11 +2376,12 @@ module IBMWatson
     # Delete a custom word.
     # Deletes a custom word from a custom language model. You can remove any word that
     #   you added to the custom model's words resource via any means. However, if the word
-    #   also exists in the service's base vocabulary, the service removes only the custom
-    #   pronunciation for the word; the word remains in the base vocabulary. Removing a
+    #   also exists in the service's base vocabulary, the service removes the word only
+    #   from the words resource; the word remains in the base vocabulary. Removing a
     #   custom word does not affect the custom model until you train the model with the
-    #   **Train a custom language model** method. You must use credentials for the
-    #   instance of the service that owns a model to delete its words.
+    #   [Train a custom language model](#trainlanguagemodel) method. You must use
+    #   credentials for the 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/speech-to-text?topic=speech-to-text-manageWords#deleteWord).
@@ -2228,7 +2422,11 @@ module IBMWatson
     # Lists information about all grammars from a custom language model. The information
     #   includes the total number of out-of-vocabulary (OOV) words, name, and status of
     #   each grammar. You must use credentials for the instance of the service that owns a
-    #   model to list its grammars.
+    #   model to list its grammars. Grammars are available for all languages and models
+    #   that support language customization.
+    #
+    #   **Note:** Grammars are supported only for use with previous-generation models.
+    #   They are not supported for next-generation models.
     #
     #   **See also:** [Listing grammars from a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
@@ -2262,8 +2460,8 @@ module IBMWatson
     #   UTF-8 format that defines the grammar. Use multiple requests to submit multiple
     #   grammar files. You must use credentials for the instance of the service that owns
     #   a model to add a grammar to it. Adding a grammar does not affect the custom
-    #   language model until you train the model for the new data by using the **Train a
-    #   custom language model** method.
+    #   language model until you train the model for the new data by using the [Train a
+    #   custom language model](#trainlanguagemodel) method.
     #
     #   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
@@ -2271,27 +2469,33 @@ module IBMWatson
     #   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.
+    #   of the grammar for the current request completes. Use the [Get a
+    #   grammar](#getgrammar) 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
-    #   referred to as out-of-vocabulary (OOV) words. You can use the **List custom
-    #   words** method to examine the words resource and use other words-related methods
-    #   to eliminate typos and modify how words are pronounced as needed.
+    #   referred to as out-of-vocabulary (OOV) words. You can use the [List custom
+    #   words](#listwords) method to examine the words resource and use other
+    #   words-related methods to eliminate typos and modify how words are pronounced as
+    #   needed.
     #
     #   To add a grammar that has the same name as an existing grammar, set the
     #   `allow_overwrite` parameter to `true`; otherwise, the request fails. Overwriting
     #   an existing grammar causes the service to process the grammar file and extract OOV
     #   words anew. Before doing so, it removes any OOV words associated with the existing
     #   grammar from the model's words resource unless they were also added by another
-    #   resource or they have been modified in some way with the **Add custom words** or
-    #   **Add a custom word** method.
+    #   resource or they have been modified in some way with the [Add custom
+    #   words](#addwords) or [Add a custom word](#addword) method.
     #
     #   The service limits the overall amount of data that you can add to a custom model
     #   to a maximum of 10 million total words from all sources combined. Also, you can
     #   add no more than 90 thousand OOV words to a model. This includes words that the
     #   service extracts from corpora and grammars and words that you add directly.
+    #   Grammars are available for all languages and models that support language
+    #   customization.
+    #
+    #   **Note:** Grammars are supported only for use with previous-generation models.
+    #   They are not supported for next-generation models.
     #
     #   **See also:**
     #   * [Understanding
@@ -2374,7 +2578,11 @@ module IBMWatson
     # Gets information about a grammar from a custom language model. The information
     #   includes the total number of out-of-vocabulary (OOV) words, name, and status of
     #   the grammar. You must use credentials for the instance of the service that owns a
-    #   model to list its grammars.
+    #   model to list its grammars. Grammars are available for all languages and models
+    #   that support language customization.
+    #
+    #   **Note:** Grammars are supported only for use with previous-generation models.
+    #   They are not supported for next-generation models.
     #
     #   **See also:** [Listing grammars from a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
@@ -2410,10 +2618,15 @@ module IBMWatson
     # Deletes an existing grammar from a custom language model. The service removes any
     #   out-of-vocabulary (OOV) words associated with the grammar from the custom model's
     #   words resource unless they were also added by another resource or they were
-    #   modified in some way with the **Add custom words** or **Add a custom word**
-    #   method. Removing a grammar does not affect the custom model until you train the
-    #   model with the **Train a custom language model** method. You must use credentials
-    #   for the instance of the service that owns a model to delete its grammar.
+    #   modified in some way with the [Add custom words](#addwords) or [Add a custom
+    #   word](#addword) method. Removing a grammar does not affect the custom model until
+    #   you train the model with the [Train a custom language model](#trainlanguagemodel)
+    #   method. You must use credentials for the instance of the service that owns a model
+    #   to delete its grammar. Grammars are available for all languages and models that
+    #   support language customization.
+    #
+    #   **Note:** Grammars are supported only for use with previous-generation models.
+    #   They are not supported for next-generation models.
     #
     #   **See also:** [Deleting a grammar from a custom language
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#deleteGrammar).
@@ -2459,6 +2672,9 @@ module IBMWatson
     #   do not lose any models, but you cannot create any more until your model count is
     #   below the limit.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Create a custom 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
@@ -2468,11 +2684,12 @@ module IBMWatson
     #   custom model`.
     # @param base_model_name [String] The name of the base language model that is to be customized by the new custom
     #   acoustic model. The new custom model can be used only with the base model that it
-    #   customizes.
+    #   customizes. (**Note:** The model `ar-AR_BroadbandModel` is deprecated; use
+    #   `ar-MS_BroadbandModel` instead.)
     #
     #   To determine whether a base model supports acoustic model customization, refer to
     #   [Language support for
-    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support#custom-language-support).
     # @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.
@@ -2513,15 +2730,19 @@ module IBMWatson
     #   all languages. You must use credentials for the instance of the service that owns
     #   a model to list information about it.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Listing custom 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. Omit the parameter to see all custom language or custom
-    #   acoustic models that are owned by the requesting credentials.
+    #   acoustic models that are owned by the requesting credentials. (**Note:** The
+    #   identifier `ar-AR` is deprecated; use `ar-MS` instead.)
     #
     #   To determine the languages for which customization is available, see [Language
     #   support for
-    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support#custom-language-support).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_acoustic_models(language: nil)
       headers = {
@@ -2551,6 +2772,9 @@ module IBMWatson
     # Gets information about a specified custom acoustic model. You must use credentials
     #   for the instance of the service that owns a model to list information about it.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Listing custom 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
@@ -2584,6 +2808,9 @@ module IBMWatson
     #   processed. You must use credentials for the instance of the service that owns a
     #   model to delete it.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Deleting a custom 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
@@ -2628,14 +2855,14 @@ module IBMWatson
     #   audio. The method returns an HTTP 200 response code to indicate that the training
     #   process has begun.
     #
-    #   You can monitor the status of the training by using the **Get a custom acoustic
-    #   model** method to poll the model's status. Use a loop to check the status once a
-    #   minute. The method returns an `AcousticModel` object that includes `status` and
-    #   `progress` fields. A status of `available` indicates that the custom model is
-    #   trained and ready to use. The service cannot train a model while it is handling
-    #   another request for the model. The service cannot accept subsequent training
-    #   requests, or requests to add new audio resources, until the existing training
-    #   request completes.
+    #   You can monitor the status of the training by using the [Get a custom acoustic
+    #   model](#getacousticmodel) method to poll the model's status. Use a loop to check
+    #   the status once a minute. The method returns an `AcousticModel` object that
+    #   includes `status` and `progress` fields. A status of `available` indicates that
+    #   the custom model is trained and ready to use. The service cannot train a model
+    #   while it is handling another request for the model. The service cannot accept
+    #   subsequent training requests, or requests to add new audio resources, until the
+    #   existing training request completes.
     #
     #   You can use the optional `custom_language_model_id` parameter to specify the GUID
     #   of a separately created custom language model that is to be used during training.
@@ -2646,6 +2873,9 @@ module IBMWatson
     #   same version of the same base model, and the custom language model must be fully
     #   trained and available.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:**
     #   * [Train the custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acoustic#trainModel-acoustic)
@@ -2717,6 +2947,9 @@ module IBMWatson
     #   request completes. You must use credentials for the instance of the service that
     #   owns a model to reset it.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Resetting a custom 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
@@ -2755,14 +2988,14 @@ module IBMWatson
     #
     #   The method returns an HTTP 200 response code to indicate that the upgrade process
     #   has begun successfully. You can monitor the status of the upgrade by using the
-    #   **Get a custom acoustic model** method to poll the model's status. The method
-    #   returns an `AcousticModel` object that includes `status` and `progress` fields.
-    #   Use a loop to check the status once a minute. While it is being upgraded, the
-    #   custom model has the status `upgrading`. When the upgrade is complete, the model
-    #   resumes the status that it had prior to upgrade. The service cannot upgrade a
-    #   model while it is handling another request for the model. The service cannot
-    #   accept subsequent requests for the model until the existing upgrade request
-    #   completes.
+    #   [Get a custom acoustic model](#getacousticmodel) method to poll the model's
+    #   status. The method returns an `AcousticModel` object that includes `status` and
+    #   `progress` fields. Use a loop to check the status once a minute. While it is being
+    #   upgraded, the custom model has the status `upgrading`. When the upgrade is
+    #   complete, the model resumes the status that it had prior to upgrade. The service
+    #   cannot upgrade a model while it is handling another request for the model. The
+    #   service cannot accept subsequent requests for the model until the existing upgrade
+    #   request completes.
     #
     #   If the custom acoustic model was trained with a separately created custom language
     #   model, you must use the `custom_language_model_id` parameter to specify the GUID
@@ -2770,8 +3003,11 @@ module IBMWatson
     #   the custom acoustic model can be upgraded. Omit the parameter if the custom
     #   acoustic model was not trained with a custom language model.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Upgrading a custom acoustic
-    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customUpgrade#upgradeAcoustic).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-upgrade#custom-upgrade-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.
@@ -2785,7 +3021,7 @@ module IBMWatson
     #   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/speech-to-text?topic=speech-to-text-customUpgrade#upgradeAcoustic).
+    #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-upgrade#custom-upgrade-acoustic).
     # @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?
@@ -2825,6 +3061,9 @@ module IBMWatson
     #   to a request to add it to the custom acoustic model. You must use credentials for
     #   the instance of the service that owns a model to list its audio resources.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Listing audio resources for a custom acoustic
     #   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
@@ -2857,8 +3096,8 @@ module IBMWatson
     #   the acoustic characteristics of the audio that you plan to transcribe. You must
     #   use credentials for the instance of the service that owns a model to add an audio
     #   resource to it. Adding audio data does not affect the custom acoustic model until
-    #   you train the model for the new data by using the **Train a custom acoustic
-    #   model** method.
+    #   you train the model for the new data by using the [Train a custom acoustic
+    #   model](#trainacousticmodel) method.
     #
     #   You can add individual audio files or an archive file that contains multiple audio
     #   files. Adding multiple audio files via a single archive file is significantly more
@@ -2883,11 +3122,14 @@ module IBMWatson
     #   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
-    #   customization ID of the custom model and the name of the audio resource, and it
-    #   returns the status of the resource. Use a loop to check the status of the audio
-    #   every few seconds until it becomes `ok`.
+    #   To determine the status of the service's analysis of the audio, use the [Get an
+    #   audio resource](#getaudio) method to poll the status of the audio. The method
+    #   accepts the customization ID of the custom model and the name of the audio
+    #   resource, and it returns the status of the resource. Use a loop to check the
+    #   status of the audio every few seconds until it becomes `ok`.
+    #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
     #
     #   **See also:** [Add audio to the custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acoustic#addAudio).
@@ -2923,8 +3165,8 @@ module IBMWatson
     #   If the sampling rate of the audio is lower than the minimum required rate, the
     #   service labels the audio file as `invalid`.
     #
-    #    **See also:** [Audio
-    #   formats](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
+    #    **See also:** [Supported audio
+    #   formats](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-audio-formats).
     #
     #
     #   ### Content types for archive-type resources
@@ -2982,7 +3224,7 @@ module IBMWatson
     #   For an archive-type resource, the media type of the archive file. For more
     #   information, see **Content types for archive-type resources** in the method
     #   description.
-    # @param contained_content_type [String] **For an archive-type resource,** specify the format of the audio files that are
+    # @param contained_content_type [String] _For an archive-type resource_, specify the format of the audio files that are
     #   contained in the archive file if they are of type `audio/alaw`, `audio/basic`,
     #   `audio/l16`, or `audio/mulaw`. Include the `rate`, `channels`, and `endianness`
     #   parameters where necessary. In this case, all audio files that are contained in
@@ -2996,7 +3238,7 @@ module IBMWatson
     #   speech recognition. For more information, see **Content types for audio-type
     #   resources** in the method description.
     #
-    #   **For an audio-type resource,** omit the header.
+    #   _For an audio-type resource_, omit the header.
     # @param allow_overwrite [Boolean] If `true`, the specified audio resource overwrites an existing audio resource with
     #   the same name. If `false`, the request fails if an audio resource with the same
     #   name already exists. The parameter has no effect if an audio resource with the
@@ -3041,9 +3283,9 @@ module IBMWatson
     # Gets information about an audio resource from a custom acoustic model. The method
     #   returns an `AudioListing` object whose fields depend on the type of audio resource
     #   that you specify with the method's `audio_name` parameter:
-    #   * **For an audio-type resource,** the object's fields match those of an
+    #   * _For an audio-type resource_, the object's fields match those of an
     #   `AudioResource` object: `duration`, `name`, `details`, and `status`.
-    #   * **For an archive-type resource,** the object includes a `container` field whose
+    #   * _For an archive-type resource_, the object includes a `container` field whose
     #   fields match those of an `AudioResource` object. It also includes an `audio`
     #   field, which contains an array of `AudioResource` objects that provides
     #   information about the audio files that are contained in the archive.
@@ -3051,14 +3293,17 @@ module IBMWatson
     #   The information includes the status of the specified audio resource. The status is
     #   important for checking the service's analysis of a resource that you add to the
     #   custom model.
-    #   * For an audio-type resource, the `status` field is located in the `AudioListing`
-    #   object.
-    #   * For an archive-type resource, the `status` field is located in the
+    #   * _For an audio-type resource_, the `status` field is located in the
+    #   `AudioListing` object.
+    #   * _For an archive-type resource_, the `status` field is located in the
     #   `AudioResource` object that is returned in the `container` field.
     #
     #   You must use credentials for the instance of the service that owns a model to list
     #   its audio resources.
     #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
+    #
     #   **See also:** [Listing audio resources for a custom acoustic
     #   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
@@ -3095,10 +3340,14 @@ module IBMWatson
     #   not allow deletion of individual files from an archive resource.
     #
     #   Removing an audio resource does not affect the custom model until you train the
-    #   model on its updated data by using the **Train a custom acoustic model** method.
-    #   You can delete an existing audio resource from a model while a different resource
-    #   is being added to the model. You must use credentials for the instance of the
-    #   service that owns a model to delete its audio resources.
+    #   model on its updated data by using the [Train a custom acoustic
+    #   model](#trainacousticmodel) method. You can delete an existing audio resource from
+    #   a model while a different resource is being added to the model. You must use
+    #   credentials for the instance of the service that owns a model to delete its audio
+    #   resources.
+    #
+    #   **Note:** Acoustic model customization is supported only for use with
+    #   previous-generation models. It is not supported for next-generation models.
     #
     #   **See also:** [Deleting an audio resource from a custom acoustic
     #   model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAudio#deleteAudio).