ibm_watson 0.16.1 → 0.17.0

data/lib/ibm_watson/speech_to_text_v1.rb

@@ -57,16 +57,16 @@ module IBMWatson
     # @param args [Hash] The args to initialize with
     # @option args url [String] The base url to use when contacting the service (e.g.
     #   "https://stream.watsonplatform.net/speech-to-text/api").
-    #   The base url may differ between Bluemix regions.
+    #   The base url may differ between IBM Cloud regions.
     # @option args username [String] The username used to authenticate with the service.
     #   Username and password credentials are only required to run your
-    #   application locally or outside of Bluemix. When running on
-    #   Bluemix, the credentials will be automatically loaded from the
+    #   application locally or outside of IBM Cloud. When running on
+    #   IBM Cloud, the credentials will be automatically loaded from the
     #   `VCAP_SERVICES` environment variable.
     # @option args password [String] The password used to authenticate with the service.
     #   Username and password credentials are only required to run your
-    #   application locally or outside of Bluemix. When running on
-    #   Bluemix, the credentials will be automatically loaded from the
+    #   application locally or outside of IBM Cloud. When running on
+    #   IBM Cloud, the credentials will be automatically loaded from the
     #   `VCAP_SERVICES` environment variable.
     # @option args iam_apikey [String] An API key that can be used to request IAM tokens. If
     #   this API key is provided, the SDK will manage the token and handle the
@@ -76,7 +76,9 @@ module IBMWatson
     #   it expires or reactively upon receiving a 401 from the service as any requests
     #   made with an expired token will fail.
     # @option args iam_url [String] An optional URL for the IAM service API. Defaults to
-    #   'https://iam.ng.bluemix.net/identity/token'.
+    #   'https://iam.cloud.ibm.com/identity/token'.
+    # @option args iam_client_id [String] An optional client id for the IAM service API.
+    # @option args iam_client_secret [String] An optional client secret for the IAM service API.
     def initialize(args = {})
       @__async_initialized__ = false
       defaults = {}
@@ -86,6 +88,8 @@ module IBMWatson
       defaults[:iam_apikey] = nil
       defaults[:iam_access_token] = nil
       defaults[:iam_url] = nil
+      defaults[:iam_client_id] = nil
+      defaults[:iam_client_secret] = nil
       args = defaults.merge(args)
       args[:vcap_services_name] = "speech_to_text"
       super
@@ -97,26 +101,22 @@ module IBMWatson
     #########################
 
     ##
-    # @!method get_model(model_id:)
-    # Get a model.
-    # Gets information for a single specified language model that is available for use
-    #   with the service. The information includes the name of the model and its minimum
-    #   sampling rate in Hertz, among other things.
+    # @!method list_models
+    # List models.
+    # Lists all language models that are available for use with the service. The
+    #   information includes the name of the model and its minimum sampling rate in Hertz,
+    #   among other things.
     #
     #   **See also:** [Languages and
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/models.html).
-    # @param model_id [String] The identifier of the model in the form of its name from the output of the **Get a
-    #   model** method.
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-models#models).
     # @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?
-
+    def list_models
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "get_model")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_models")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/models/%s" % [ERB::Util.url_encode(model_id)]
+      method_url = "/v1/models"
 
       response = request(
         method: "GET",
@@ -128,22 +128,26 @@ module IBMWatson
     end
 
     ##
-    # @!method list_models
-    # List models.
-    # Lists all language models that are available for use with the service. The
-    #   information includes the name of the model and its minimum sampling rate in Hertz,
-    #   among other things.
+    # @!method get_model(model_id:)
+    # Get a model.
+    # Gets information for a single specified language model that is available for use
+    #   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/services/speech-to-text/models.html).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-models#models).
+    # @param model_id [String] The identifier of the model in the form of its name from the output of the **Get a
+    #   model** method.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_models
+    def get_model(model_id:)
+      raise ArgumentError.new("model_id must be provided") if model_id.nil?
+
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_models")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "get_model")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/models"
+      method_url = "/v1/models/%s" % [ERB::Util.url_encode(model_id)]
 
       response = request(
         method: "GET",
@@ -158,17 +162,18 @@ module IBMWatson
     #########################
 
     ##
-    # @!method recognize(audio:, 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, content_type: nil)
+    # @!method recognize(audio:, 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, content_type: 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
     #   service automatically detects the endianness of the incoming audio and, for audio
     #   that includes multiple channels, downmixes the audio to one-channel mono during
     #   transcoding. The method returns only final results; to enable interim results, use
-    #   the WebSocket API.
+    #   the WebSocket API. (With the `curl` command, use the `--data-binary` option to
+    #   upload the file for the request.)
     #
     #   **See also:** [Making a basic HTTP
-    #   request](https://cloud.ibm.com/docs/services/speech-to-text/http.html#HTTP-basic).
+    #   request](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-http#HTTP-basic).
     #
     #
     #   ### Streaming mode
@@ -183,9 +188,9 @@ module IBMWatson
     #
     #   **See also:**
     #   * [Audio
-    #   transmission](https://cloud.ibm.com/docs/services/speech-to-text/input.html#transmission)
+    #   transmission](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#transmission)
     #   *
-    #   [Timeouts](https://cloud.ibm.com/docs/services/speech-to-text/input.html#timeouts)
+    #   [Timeouts](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#timeouts)
     #
     #
     #   ### Audio formats (content types)
@@ -225,7 +230,8 @@ module IBMWatson
     #   fails.
     #
     #    **See also:** [Audio
-    #   formats](https://cloud.ibm.com/docs/services/speech-to-text/audio-formats.html).
+    #   formats](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
+    #
     #
     #   ### Multipart speech recognition
     #
@@ -234,25 +240,26 @@ module IBMWatson
     #   The HTTP `POST` method of the service also supports multipart speech recognition.
     #   With multipart requests, you pass all audio data as multipart form data. You
     #   specify some parameters as request headers and query parameters, but you pass JSON
-    #   metadata as form data to control most aspects of the transcription.
+    #   metadata as form data to control most aspects of the transcription. You can use
+    #   multipart recognition to pass multiple audio files with a single request.
     #
-    #   The multipart approach is intended for use with browsers for which JavaScript is
-    #   disabled or when the parameters used with the request are greater than the 8 KB
-    #   limit imposed by most HTTP servers and proxies. You can encounter this limit, for
-    #   example, if you want to spot a very large number of keywords.
+    #   Use the multipart approach with browsers for which JavaScript is disabled or when
+    #   the parameters used with the request are greater than the 8 KB limit imposed by
+    #   most HTTP servers and proxies. You can encounter this limit, for example, if you
+    #   want to spot a very large number of keywords.
     #
     #   **See also:** [Making a multipart HTTP
-    #   request](https://cloud.ibm.com/docs/services/speech-to-text/http.html#HTTP-multi).
+    #   request](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-http#HTTP-multi).
     # @param audio [String] The audio to transcribe.
     # @param model [String] The identifier of the model that is to be used for the recognition request. See
     #   [Languages and
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/models.html).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-models#models).
     # @param language_customization_id [String] The customization ID (GUID) of a custom language model that is to be used with the
     #   recognition request. The base model of the specified custom language model must
     #   match the model specified with the `model` parameter. You must make the request
     #   with credentials for the instance of the service that owns the custom model. By
     #   default, no custom language model is used. See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom-input).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
     #
     #
     #   **Note:** Use this parameter instead of the deprecated `customization_id`
@@ -262,13 +269,13 @@ module IBMWatson
     #   match the model specified with the `model` parameter. You must make the request
     #   with credentials for the instance of the service that owns the custom model. By
     #   default, no custom acoustic model is used. See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom-input).
-    # @param base_model_version [String] The version of the specified base model that is to be used with recognition
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
+    # @param base_model_version [String] The version of the specified base model that is to be used with the recognition
     #   request. Multiple versions of a base model can exist when a model is updated for
     #   internal improvements. The parameter is intended primarily for use with custom
     #   models that have been upgraded for a new base model. The default value depends on
     #   whether the parameter is used with or without a custom model. See [Base model
-    #   version](https://cloud.ibm.com/docs/services/speech-to-text/input.html#version).
+    #   version](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#version).
     # @param customization_weight [Float] If you specify the customization ID (GUID) of a custom language model with the
     #   recognition request, the customization weight tells the service how much weight to
     #   give to words from the custom language model compared to those from the base model
@@ -286,45 +293,45 @@ module IBMWatson
     #   phrases.
     #
     #   See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom-input).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
     # @param inactivity_timeout [Fixnum] The time in seconds after which, if only silence (no speech) is detected in
     #   streaming audio, the connection is closed with a 400 error. The parameter is
     #   useful for stopping audio submission from a live microphone when a user simply
     #   walks away. Use `-1` for infinity. See [Inactivity
-    #   timeout](https://cloud.ibm.com/docs/services/speech-to-text/input.html#timeouts-inactivity).
+    #   timeout](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#timeouts-inactivity).
     # @param keywords [Array[String]] An array of keyword strings to spot in the audio. Each keyword string can include
     #   one or more string tokens. Keywords are spotted only in the final results, not in
     #   interim hypotheses. If you specify any keywords, you must also specify a keywords
     #   threshold. You can spot a maximum of 1000 keywords. Omit the parameter or specify
     #   an empty array if you do not need to spot keywords. See [Keyword
-    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#keyword_spotting).
+    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#keyword_spotting).
     # @param keywords_threshold [Float] A confidence value that is the lower bound for spotting a keyword. A word is
     #   considered to match a keyword if its confidence is greater than or equal to the
     #   threshold. Specify a probability between 0.0 and 1.0. If you specify a threshold,
     #   you must also specify one or more keywords. The service performs no keyword
     #   spotting if you omit either parameter. See [Keyword
-    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#keyword_spotting).
+    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#keyword_spotting).
     # @param max_alternatives [Fixnum] The maximum number of alternative transcripts that the service is to return. By
     #   default, the service returns a single transcript. If you specify a value of `0`,
     #   the service uses the default value, `1`. See [Maximum
-    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text/output.html#max_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#max_alternatives).
     # @param word_alternatives_threshold [Float] A confidence value that is the lower bound for identifying a hypothesis as a
     #   possible word alternative (also known as \"Confusion Networks\"). An alternative
     #   word is considered if its confidence is greater than or equal to the threshold.
     #   Specify a probability between 0.0 and 1.0. By default, the service computes no
     #   alternative words. See [Word
-    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_alternatives).
     # @param word_confidence [Boolean] If `true`, the service returns a confidence measure in the range of 0.0 to 1.0 for
     #   each word. By default, the service returns no word confidence scores. See [Word
-    #   confidence](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_confidence).
+    #   confidence](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_confidence).
     # @param timestamps [Boolean] If `true`, the service returns time alignment for each word. By default, no
     #   timestamps are returned. See [Word
-    #   timestamps](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_timestamps).
+    #   timestamps](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_timestamps).
     # @param profanity_filter [Boolean] If `true`, the service filters profanity from all output except for keyword
     #   results by replacing inappropriate words with a series of asterisks. Set the
     #   parameter to `false` to return results with no censoring. Applies to US English
     #   transcription only. See [Profanity
-    #   filtering](https://cloud.ibm.com/docs/services/speech-to-text/output.html#profanity_filter).
+    #   filtering](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#profanity_filter).
     # @param smart_formatting [Boolean] If `true`, the service converts dates, times, series of digits and numbers, phone
     #   numbers, currency values, and internet addresses into more readable, conventional
     #   representations in the final transcript of a recognition request. For US English,
@@ -334,7 +341,7 @@ module IBMWatson
     #   **Note:** Applies to US English, Japanese, and Spanish transcription only.
     #
     #   See [Smart
-    #   formatting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#smart_formatting).
+    #   formatting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#smart_formatting).
     # @param speaker_labels [Boolean] If `true`, the response includes labels that identify which words were spoken by
     #   which participants in a multi-person exchange. By default, the service returns no
     #   speaker labels. Setting `speaker_labels` to `true` forces the `timestamps`
@@ -347,7 +354,7 @@ module IBMWatson
     #   `true`.
     #
     #   See [Speaker
-    #   labels](https://cloud.ibm.com/docs/services/speech-to-text/output.html#speaker_labels).
+    #   labels](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#speaker_labels).
     # @param customization_id [String] **Deprecated.** Use the `language_customization_id` parameter to specify the
     #   customization ID (GUID) of a custom language model that is to be used with the
     #   recognition request. Do not specify both parameters with a request.
@@ -356,7 +363,7 @@ module IBMWatson
     #   specify the name of the custom language model for which the grammar is defined.
     #   The service recognizes only strings that are recognized by the specified grammar;
     #   it does not recognize other custom words from the model's words resource. See
-    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text/input.html#grammars-input).
+    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#grammars-input).
     # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
     #   feature redacts any number that has three or more consecutive digits by replacing
     #   each digit with an `X` character. It is intended to redact sensitive numeric data,
@@ -371,11 +378,17 @@ module IBMWatson
     #   **Note:** Applies to US English, Japanese, and Korean transcription only.
     #
     #   See [Numeric
-    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text/output.html#redaction).
+    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#redaction).
+    #   The parameter accepts a minimum value of 0.1 seconds. The level of precision is
+    #   not restricted, so you can specify values such as 0.25 and 0.125.
+    #
+    # @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.
     # @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.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def recognize(audio:, 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, content_type: nil)
+    def recognize(audio:, 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, content_type: nil)
       raise ArgumentError.new("audio must be provided") if audio.nil?
 
       headers = {
@@ -403,7 +416,8 @@ module IBMWatson
         "speaker_labels" => speaker_labels,
         "customization_id" => customization_id,
         "grammar_name" => grammar_name,
-        "redaction" => redaction
+        "redaction" => redaction,
+        "audio_metrics" => audio_metrics
       }
 
       data = audio
@@ -422,7 +436,7 @@ module IBMWatson
     end
 
     ##
-    # @!method recognize_using_websocket(content_type:,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)
+    # @!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)
     # 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.
@@ -432,7 +446,6 @@ module IBMWatson
     # @param customization_id [String] The GUID of a custom language model that is to be used with the request. The base model of the specified custom language model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom language model is used.
     # @param acoustic_customization_id [String] The GUID of a custom acoustic model that is to be used with the request. The base model of the specified custom acoustic model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom acoustic model is used.
     # @param language_customization_id [String] The GUID of a custom language model that is to be used with the request. The base model of the specified custom language model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom language model is used.
-    # @param customization_weight [Float] If you specify a `customization_id` with the request, you can use the `customization_weight` parameter to tell the service how much weight to give to words from the custom language model compared to those from the base model for speech recognition.   Specify a value between 0.0 and 1.0. Unless a different customization weight was specified for the custom model when it was trained, the default value is 0.3. A customization weight that you specify overrides a weight that was specified when the custom model was trained.   The default value yields the best performance in general. Assign a higher value if your audio makes frequent use of OOV words from the custom model. Use caution when setting the weight: a higher value can improve the accuracy of phrases from the custom model's domain, but it can negatively affect performance on non-domain phrases.
     # @param base_model_version [String] The version of the specified base `model` that is to be used for speech recognition. Multiple versions of a base model can exist when a model is updated for internal improvements. The parameter is intended primarily for use with custom models that have been upgraded for a new base model. The default value depends on whether the parameter is used with or without a custom model. For more information, see [Base model version](https://console.bluemix.net/docs/services/speech-to-text/input.html#version).
     # @param inactivity_timeout [Integer] The time in seconds after which, if only silence (no speech) is detected in submitted audio, the connection is closed with a 400 error. Useful for stopping audio submission from a live microphone when a user simply walks away. Use `-1` for infinity.
     # @param interim_results [Boolean] Send back non-final previews of each "sentence" as it is being processed. These results are ignored in text mode.
@@ -466,6 +479,24 @@ module IBMWatson
     #
     #   See [Numeric
     #   redaction](https://cloud.ibm.com/docs/services/speech-to-text/output.html#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
+    #   for transcription events, for example, for final and interim results. By default,
+    #   the service returns no 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`.    #   The parameter accepts a minimum value of 0.1 seconds. The level of precision is
+    #   not restricted, so you can specify values such as 0.25 and 0.125.
+    #
+    #   The service does not impose a maximum value. If you want to receive processing
+    #   metrics only for transcription events instead of at periodic intervals, set the
+    #   value to a large number. If the value is larger than the duration of the audio,
+    #   the service returns processing metrics only for transcription events.
+    # @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.
     # @return [WebSocketClient] Returns a new WebSocketClient object
     def recognize_using_websocket(
       content_type: nil,
@@ -490,7 +521,10 @@ module IBMWatson
       smart_formatting: nil,
       speaker_labels: nil,
       grammar_name: nil,
-      redaction: nil
+      redaction: nil,
+      processing_metrics: nil,
+      processing_metrics_interval: nil,
+      audio_metrics: nil
     )
       raise ArgumentError("Audio must be provided") if audio.nil? && !chunk_data
       raise ArgumentError("Recognize callback must be provided") if recognize_callback.nil?
@@ -530,7 +564,10 @@ module IBMWatson
         "smart_formatting" => smart_formatting,
         "speaker_labels" => speaker_labels,
         "grammar_name" => grammar_name,
-        "redaction" => redaction
+        "redaction" => redaction,
+        "processing_metrics" => processing_metrics,
+        "processing_metrics_interval" => processing_metrics_interval,
+        "audio_metrics" => audio_metrics
       }
       options.delete_if { |_, v| v.nil? }
       WebSocketClient.new(audio: audio, chunk_data: chunk_data, options: options, recognize_callback: recognize_callback, url: url, headers: headers, disable_ssl_verification: @disable_ssl_verification)
@@ -590,79 +627,115 @@ module IBMWatson
     #########################
 
     ##
-    # @!method check_job(id:)
-    # Check a job.
-    # Returns information about the specified job. The response always includes the
-    #   status of the job and its creation and update times. If the status is `completed`,
-    #   the response includes the results of the recognition request. You must use
-    #   credentials for the instance of the service that owns a job to list information
-    #   about it.
+    # @!method register_callback(callback_url:, user_secret: nil)
+    # Register a callback.
+    # Registers a callback URL with the service for use with subsequent asynchronous
+    #   recognition requests. The service attempts to register, or white-list, the
+    #   callback URL if it is not already registered by sending a `GET` request to the
+    #   callback URL. The service passes a random alphanumeric challenge string via the
+    #   `challenge_string` parameter of the request. The request includes an `Accept`
+    #   header that specifies `text/plain` as the required response type.
     #
-    #   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.
+    #   To be registered successfully, the callback URL must respond to the `GET` request
+    #   from the service. The response must send status code 200 and must include the
+    #   challenge string in its body. Set the `Content-Type` response header to
+    #   `text/plain`. Upon receiving this response, the service responds to the original
+    #   registration request with response code 201.
     #
-    #   **See also:** [Checking the status and retrieving the results of a
-    #   job](https://cloud.ibm.com/docs/services/speech-to-text/async.html#job).
-    # @param id [String] The identifier of the asynchronous job that is to be used for the request. You
-    #   must make the request with credentials for the instance of the service that owns
-    #   the job.
+    #   The service sends only a single `GET` request to the callback URL. If the service
+    #   does not receive a reply with a response code of 200 and a body that echoes the
+    #   challenge string sent by the service within five seconds, it does not white-list
+    #   the URL; it instead sends status code 400 in response to the **Register a
+    #   callback** request. If the requested callback URL is already white-listed, the
+    #   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
+    #   `POST` request. It sends this signature in the `X-Callback-Signature` header of
+    #   its `GET` request to the URL during registration. It also uses the secret to
+    #   calculate a signature over the payload of every callback notification that uses
+    #   the URL. The signature provides authentication and data integrity for HTTP
+    #   communications.
+    #
+    #   After you successfully register a callback URL, you can use it with an indefinite
+    #   number of recognition requests. You can register a maximum of 20 callback URLS in
+    #   a one-hour span of time.
+    #
+    #   **See also:** [Registering a callback
+    #   URL](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#register).
+    # @param callback_url [String] An HTTP or HTTPS URL to which callback notifications are to be sent. To be
+    #   white-listed, the URL must successfully echo the challenge string during URL
+    #   verification. During verification, the client can also check the signature that
+    #   the service sends in the `X-Callback-Signature` header to verify the origin of the
+    #   request.
+    # @param user_secret [String] A user-specified string that the service uses to generate the HMAC-SHA1 signature
+    #   that it sends via the `X-Callback-Signature` header. The service includes the
+    #   header during URL verification and with every notification sent to the callback
+    #   URL. It calculates the signature over the payload of the notification. If you omit
+    #   the parameter, the service does not send the header.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def check_job(id:)
-      raise ArgumentError.new("id must be provided") if id.nil?
+    def register_callback(callback_url:, user_secret: nil)
+      raise ArgumentError.new("callback_url must be provided") if callback_url.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "check_job")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "register_callback")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/recognitions/%s" % [ERB::Util.url_encode(id)]
+      params = {
+        "callback_url" => callback_url,
+        "user_secret" => user_secret
+      }
+
+      method_url = "/v1/register_callback"
 
       response = request(
-        method: "GET",
+        method: "POST",
         url: method_url,
         headers: headers,
+        params: params,
         accept_json: true
       )
       response
     end
 
     ##
-    # @!method check_jobs
-    # Check jobs.
-    # Returns the ID and status of the latest 100 outstanding jobs associated with the
-    #   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.
+    # @!method unregister_callback(callback_url:)
+    # Unregister a callback.
+    # Unregisters a callback URL that was previously white-listed with a **Register a
+    #   callback** request for use with the asynchronous interface. Once unregistered, the
+    #   URL can no longer be used with asynchronous recognition requests.
     #
-    #   **See also:** [Checking the status of the latest
-    #   jobs](https://cloud.ibm.com/docs/services/speech-to-text/async.html#jobs).
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def check_jobs
+    #   **See also:** [Unregistering a callback
+    #   URL](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#unregister).
+    # @param callback_url [String] The callback URL that is to be unregistered.
+    # @return [nil]
+    def unregister_callback(callback_url:)
+      raise ArgumentError.new("callback_url must be provided") if callback_url.nil?
+
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "check_jobs")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "unregister_callback")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/recognitions"
+      params = {
+        "callback_url" => callback_url
+      }
 
-      response = request(
-        method: "GET",
+      method_url = "/v1/unregister_callback"
+
+      request(
+        method: "POST",
         url: method_url,
         headers: headers,
-        accept_json: true
+        params: params,
+        accept_json: false
       )
-      response
+      nil
     end
 
     ##
-    # @!method create_job(audio:, 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, content_type: nil)
+    # @!method create_job(audio:, 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, audio_metrics: nil, content_type: 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
@@ -698,10 +771,12 @@ module IBMWatson
     #   The service automatically detects the endianness of the incoming audio and, for
     #   audio that includes multiple channels, downmixes the audio to one-channel mono
     #   during transcoding. The method returns only final results; to enable interim
-    #   results, use the WebSocket API.
+    #   results, use the WebSocket API. (With the `curl` command, use the `--data-binary`
+    #   option to upload the file for the request.)
     #
     #   **See also:** [Creating a
-    #   job](https://cloud.ibm.com/docs/services/speech-to-text/async.html#create).
+    #   job](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#create).
+    #
     #
     #   ### Streaming mode
     #
@@ -715,9 +790,9 @@ module IBMWatson
     #
     #   **See also:**
     #   * [Audio
-    #   transmission](https://cloud.ibm.com/docs/services/speech-to-text/input.html#transmission)
+    #   transmission](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#transmission)
     #   *
-    #   [Timeouts](https://cloud.ibm.com/docs/services/speech-to-text/input.html#timeouts)
+    #   [Timeouts](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#timeouts)
     #
     #
     #   ### Audio formats (content types)
@@ -757,11 +832,11 @@ module IBMWatson
     #   fails.
     #
     #    **See also:** [Audio
-    #   formats](https://cloud.ibm.com/docs/services/speech-to-text/audio-formats.html).
+    #   formats](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
     # @param audio [String] The audio to transcribe.
     # @param model [String] The identifier of the model that is to be used for the recognition request. See
     #   [Languages and
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/models.html).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-models#models).
     # @param callback_url [String] A URL to which callback notifications are to be sent. The URL must already be
     #   successfully white-listed by using the **Register a callback** method. You can
     #   include the same callback URL with any number of job creation requests. Omit the
@@ -801,7 +876,7 @@ module IBMWatson
     #   match the model specified with the `model` parameter. You must make the request
     #   with credentials for the instance of the service that owns the custom model. By
     #   default, no custom language model is used. See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom-input).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
     #
     #
     #   **Note:** Use this parameter instead of the deprecated `customization_id`
@@ -811,13 +886,13 @@ module IBMWatson
     #   match the model specified with the `model` parameter. You must make the request
     #   with credentials for the instance of the service that owns the custom model. By
     #   default, no custom acoustic model is used. See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom-input).
-    # @param base_model_version [String] The version of the specified base model that is to be used with recognition
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
+    # @param base_model_version [String] The version of the specified base model that is to be used with the recognition
     #   request. Multiple versions of a base model can exist when a model is updated for
     #   internal improvements. The parameter is intended primarily for use with custom
     #   models that have been upgraded for a new base model. The default value depends on
     #   whether the parameter is used with or without a custom model. See [Base model
-    #   version](https://cloud.ibm.com/docs/services/speech-to-text/input.html#version).
+    #   version](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#version).
     # @param customization_weight [Float] If you specify the customization ID (GUID) of a custom language model with the
     #   recognition request, the customization weight tells the service how much weight to
     #   give to words from the custom language model compared to those from the base model
@@ -835,45 +910,45 @@ module IBMWatson
     #   phrases.
     #
     #   See [Custom
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/input.html#custom-input).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#custom-input).
     # @param inactivity_timeout [Fixnum] The time in seconds after which, if only silence (no speech) is detected in
     #   streaming audio, the connection is closed with a 400 error. The parameter is
     #   useful for stopping audio submission from a live microphone when a user simply
     #   walks away. Use `-1` for infinity. See [Inactivity
-    #   timeout](https://cloud.ibm.com/docs/services/speech-to-text/input.html#timeouts-inactivity).
+    #   timeout](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#timeouts-inactivity).
     # @param keywords [Array[String]] An array of keyword strings to spot in the audio. Each keyword string can include
     #   one or more string tokens. Keywords are spotted only in the final results, not in
     #   interim hypotheses. If you specify any keywords, you must also specify a keywords
     #   threshold. You can spot a maximum of 1000 keywords. Omit the parameter or specify
     #   an empty array if you do not need to spot keywords. See [Keyword
-    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#keyword_spotting).
+    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#keyword_spotting).
     # @param keywords_threshold [Float] A confidence value that is the lower bound for spotting a keyword. A word is
     #   considered to match a keyword if its confidence is greater than or equal to the
     #   threshold. Specify a probability between 0.0 and 1.0. If you specify a threshold,
     #   you must also specify one or more keywords. The service performs no keyword
     #   spotting if you omit either parameter. See [Keyword
-    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#keyword_spotting).
+    #   spotting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#keyword_spotting).
     # @param max_alternatives [Fixnum] The maximum number of alternative transcripts that the service is to return. By
     #   default, the service returns a single transcript. If you specify a value of `0`,
     #   the service uses the default value, `1`. See [Maximum
-    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text/output.html#max_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#max_alternatives).
     # @param word_alternatives_threshold [Float] A confidence value that is the lower bound for identifying a hypothesis as a
     #   possible word alternative (also known as \"Confusion Networks\"). An alternative
     #   word is considered if its confidence is greater than or equal to the threshold.
     #   Specify a probability between 0.0 and 1.0. By default, the service computes no
     #   alternative words. See [Word
-    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_alternatives).
+    #   alternatives](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_alternatives).
     # @param word_confidence [Boolean] If `true`, the service returns a confidence measure in the range of 0.0 to 1.0 for
     #   each word. By default, the service returns no word confidence scores. See [Word
-    #   confidence](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_confidence).
+    #   confidence](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_confidence).
     # @param timestamps [Boolean] If `true`, the service returns time alignment for each word. By default, no
     #   timestamps are returned. See [Word
-    #   timestamps](https://cloud.ibm.com/docs/services/speech-to-text/output.html#word_timestamps).
+    #   timestamps](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#word_timestamps).
     # @param profanity_filter [Boolean] If `true`, the service filters profanity from all output except for keyword
     #   results by replacing inappropriate words with a series of asterisks. Set the
     #   parameter to `false` to return results with no censoring. Applies to US English
     #   transcription only. See [Profanity
-    #   filtering](https://cloud.ibm.com/docs/services/speech-to-text/output.html#profanity_filter).
+    #   filtering](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#profanity_filter).
     # @param smart_formatting [Boolean] If `true`, the service converts dates, times, series of digits and numbers, phone
     #   numbers, currency values, and internet addresses into more readable, conventional
     #   representations in the final transcript of a recognition request. For US English,
@@ -883,7 +958,7 @@ module IBMWatson
     #   **Note:** Applies to US English, Japanese, and Spanish transcription only.
     #
     #   See [Smart
-    #   formatting](https://cloud.ibm.com/docs/services/speech-to-text/output.html#smart_formatting).
+    #   formatting](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#smart_formatting).
     # @param speaker_labels [Boolean] If `true`, the response includes labels that identify which words were spoken by
     #   which participants in a multi-person exchange. By default, the service returns no
     #   speaker labels. Setting `speaker_labels` to `true` forces the `timestamps`
@@ -896,7 +971,7 @@ module IBMWatson
     #   `true`.
     #
     #   See [Speaker
-    #   labels](https://cloud.ibm.com/docs/services/speech-to-text/output.html#speaker_labels).
+    #   labels](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#speaker_labels).
     # @param customization_id [String] **Deprecated.** Use the `language_customization_id` parameter to specify the
     #   customization ID (GUID) of a custom language model that is to be used with the
     #   recognition request. Do not specify both parameters with a request.
@@ -905,7 +980,7 @@ module IBMWatson
     #   specify the name of the custom language model for which the grammar is defined.
     #   The service recognizes only strings that are recognized by the specified grammar;
     #   it does not recognize other custom words from the model's words resource. See
-    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text/input.html#grammars-input).
+    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-input#grammars-input).
     # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
     #   feature redacts any number that has three or more consecutive digits by replacing
     #   each digit with an `X` character. It is intended to redact sensitive numeric data,
@@ -920,11 +995,29 @@ module IBMWatson
     #   **Note:** Applies to US English, Japanese, and Korean transcription only.
     #
     #   See [Numeric
-    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text/output.html#redaction).
+    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#redaction).
+    #
+    # @param processing_metrics [Boolean] If `true`, requests processing metrics about the service's transcription of the
+    #   input audio. The service returns processing metrics at the interval specified by
+    #   the `processing_metrics_interval` parameter. It also returns processing metrics
+    #   for transcription events, for example, for final and interim results. By default,
+    #   the service returns no 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`.    #   The parameter accepts a minimum value of 0.1 seconds. The level of precision is
+    #   not restricted, so you can specify values such as 0.25 and 0.125.
+    #
+    #   The service does not impose a maximum value. If you want to receive processing
+    #   metrics only for transcription events instead of at periodic intervals, set the
+    #   value to a large number. If the value is larger than the duration of the audio,
+    #   the service returns processing metrics only for transcription events.
+    # @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.
     # @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.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def create_job(audio:, 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, content_type: nil)
+    def create_job(audio:, 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, content_type: nil)
       raise ArgumentError.new("audio must be provided") if audio.nil?
 
       headers = {
@@ -955,7 +1048,10 @@ module IBMWatson
         "speaker_labels" => speaker_labels,
         "customization_id" => customization_id,
         "grammar_name" => grammar_name,
-        "redaction" => redaction
+        "redaction" => redaction,
+        "processing_metrics" => processing_metrics,
+        "processing_metrics_interval" => processing_metrics_interval,
+        "audio_metrics" => audio_metrics
       }
 
       data = audio
@@ -973,6 +1069,78 @@ module IBMWatson
       response
     end
 
+    ##
+    # @!method check_jobs
+    # Check jobs.
+    # Returns the ID and status of the latest 100 outstanding jobs associated with the
+    #   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.
+    #
+    #   **See also:** [Checking the status of the latest
+    #   jobs](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#jobs).
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def check_jobs
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "check_jobs")
+      headers.merge!(sdk_headers)
+
+      method_url = "/v1/recognitions"
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        accept_json: true
+      )
+      response
+    end
+
+    ##
+    # @!method check_job(id:)
+    # Check a job.
+    # Returns information about the specified job. The response always includes the
+    #   status of the job and its creation and update times. If the status is `completed`,
+    #   the response includes the results of the recognition request. You must use
+    #   credentials for the instance of the service that owns a job to list information
+    #   about it.
+    #
+    #   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.
+    #
+    #   **See also:** [Checking the status and retrieving the results of a
+    #   job](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#job).
+    # @param id [String] The identifier of the asynchronous job that is to be used for the request. You
+    #   must make the request with credentials for the instance of the service that owns
+    #   the job.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def check_job(id:)
+      raise ArgumentError.new("id must be provided") if id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "check_job")
+      headers.merge!(sdk_headers)
+
+      method_url = "/v1/recognitions/%s" % [ERB::Util.url_encode(id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        accept_json: true
+      )
+      response
+    end
+
     ##
     # @!method delete_job(id:)
     # Delete a job.
@@ -983,7 +1151,7 @@ module IBMWatson
     #   owns a job to delete it.
     #
     #   **See also:** [Deleting a
-    #   job](https://cloud.ibm.com/docs/services/speech-to-text/async.html#delete-async).
+    #   job](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-async#delete-async).
     # @param id [String] The identifier of the asynchronous job that is to be used for the request. You
     #   must make the request with credentials for the instance of the service that owns
     #   the job.
@@ -1006,128 +1174,20 @@ module IBMWatson
       )
       nil
     end
+    #########################
+    # Custom language models
+    #########################
 
     ##
-    # @!method register_callback(callback_url:, user_secret: nil)
-    # Register a callback.
-    # Registers a callback URL with the service for use with subsequent asynchronous
-    #   recognition requests. The service attempts to register, or white-list, the
-    #   callback URL if it is not already registered by sending a `GET` request to the
-    #   callback URL. The service passes a random alphanumeric challenge string via the
-    #   `challenge_string` parameter of the request. The request includes an `Accept`
-    #   header that specifies `text/plain` as the required response type.
-    #
-    #   To be registered successfully, the callback URL must respond to the `GET` request
-    #   from the service. The response must send status code 200 and must include the
-    #   challenge string in its body. Set the `Content-Type` response header to
-    #   `text/plain`. Upon receiving this response, the service responds to the original
-    #   registration request with response code 201.
-    #
-    #   The service sends only a single `GET` request to the callback URL. If the service
-    #   does not receive a reply with a response code of 200 and a body that echoes the
-    #   challenge string sent by the service within five seconds, it does not white-list
-    #   the URL; it instead sends status code 400 in response to the **Register a
-    #   callback** request. If the requested callback URL is already white-listed, the
-    #   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
-    #   `POST` request. It sends this signature in the `X-Callback-Signature` header of
-    #   its `GET` request to the URL during registration. It also uses the secret to
-    #   calculate a signature over the payload of every callback notification that uses
-    #   the URL. The signature provides authentication and data integrity for HTTP
-    #   communications.
-    #
-    #   After you successfully register a callback URL, you can use it with an indefinite
-    #   number of recognition requests. You can register a maximum of 20 callback URLS in
-    #   a one-hour span of time.
-    #
-    #   **See also:** [Registering a callback
-    #   URL](https://cloud.ibm.com/docs/services/speech-to-text/async.html#register).
-    # @param callback_url [String] An HTTP or HTTPS URL to which callback notifications are to be sent. To be
-    #   white-listed, the URL must successfully echo the challenge string during URL
-    #   verification. During verification, the client can also check the signature that
-    #   the service sends in the `X-Callback-Signature` header to verify the origin of the
-    #   request.
-    # @param user_secret [String] A user-specified string that the service uses to generate the HMAC-SHA1 signature
-    #   that it sends via the `X-Callback-Signature` header. The service includes the
-    #   header during URL verification and with every notification sent to the callback
-    #   URL. It calculates the signature over the payload of the notification. If you omit
-    #   the parameter, the service does not send the header.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def register_callback(callback_url:, user_secret: nil)
-      raise ArgumentError.new("callback_url must be provided") if callback_url.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "register_callback")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "callback_url" => callback_url,
-        "user_secret" => user_secret
-      }
-
-      method_url = "/v1/register_callback"
-
-      response = request(
-        method: "POST",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      response
-    end
-
-    ##
-    # @!method unregister_callback(callback_url:)
-    # Unregister a callback.
-    # Unregisters a callback URL that was previously white-listed with a **Register a
-    #   callback** request for use with the asynchronous interface. Once unregistered, the
-    #   URL can no longer be used with asynchronous recognition requests.
-    #
-    #   **See also:** [Unregistering a callback
-    #   URL](https://cloud.ibm.com/docs/services/speech-to-text/async.html#unregister).
-    # @param callback_url [String] The callback URL that is to be unregistered.
-    # @return [nil]
-    def unregister_callback(callback_url:)
-      raise ArgumentError.new("callback_url must be provided") if callback_url.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "unregister_callback")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "callback_url" => callback_url
-      }
-
-      method_url = "/v1/unregister_callback"
-
-      request(
-        method: "POST",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: false
-      )
-      nil
-    end
-    #########################
-    # Custom language models
-    #########################
-
-    ##
-    # @!method create_language_model(name:, base_model_name:, dialect: nil, description: nil)
-    # Create a custom language model.
-    # Creates a new custom language model for a specified base model. The custom
-    #   language model can be used only with the base model for which it is created. The
-    #   model is owned by the instance of the service whose credentials are used to create
-    #   it.
+    # @!method create_language_model(name:, base_model_name:, dialect: nil, description: nil)
+    # Create a custom language model.
+    # Creates a new custom language model for a specified base model. The custom
+    #   language model can be used only with the base model for which it is created. The
+    #   model is owned by the instance of the service whose credentials are used to create
+    #   it.
     #
     #   **See also:** [Create a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-create.html#createModel-language).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-languageCreate#createModel-language).
     # @param name [String] A user-defined name for the new custom language model. Use a name that is unique
     #   among all custom language models that you own. Use a localized name that matches
     #   the language of the custom model. Use a name that describes the domain of the
@@ -1139,7 +1199,7 @@ module IBMWatson
     #   To determine whether a base model supports language model customization, use the
     #   **Get a model** method and check that the attribute `custom_language_model` is set
     #   to `true`. You can also refer to [Language support for
-    #   customization](https://cloud.ibm.com/docs/services/speech-to-text/custom.html#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-customization#languageSupport).
     # @param dialect [String] The dialect of the specified language that is to be used with the custom language
     #   model. The parameter is meaningful only for Spanish models, for which the service
     #   creates a custom language model that is suited for speech in one of the following
@@ -1184,36 +1244,40 @@ module IBMWatson
     end
 
     ##
-    # @!method delete_language_model(customization_id:)
-    # Delete a custom language model.
-    # Deletes an existing custom language model. The custom model cannot be deleted if
-    #   another request, such as adding a corpus or grammar to the model, is currently
-    #   being processed. You must use credentials for the instance of the service that
-    #   owns a model to delete it.
+    # @!method list_language_models(language: nil)
+    # List custom language models.
+    # Lists information about all custom language models that are owned by an instance
+    #   of the service. Use the `language` parameter to see all custom language models for
+    #   the specified language. Omit the parameter to see all custom language models for
+    #   all languages. You must use credentials for the instance of the service that owns
+    #   a model to list information about it.
     #
-    #   **See also:** [Deleting a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-models.html#deleteModel-language).
-    # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with credentials for the instance of the
-    #   service that owns the custom model.
-    # @return [nil]
-    def delete_language_model(customization_id:)
-      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
-
+    #   **See also:** [Listing custom language
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language).
+    # @param language [String] The identifier of the language for which custom language or custom acoustic models
+    #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
+    #   language or custom acoustic models that are owned by the requesting credentials.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_language_models(language: nil)
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "delete_language_model")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_language_models")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/customizations/%s" % [ERB::Util.url_encode(customization_id)]
+      params = {
+        "language" => language
+      }
 
-      request(
-        method: "DELETE",
+      method_url = "/v1/customizations"
+
+      response = request(
+        method: "GET",
         url: method_url,
         headers: headers,
+        params: params,
         accept_json: true
       )
-      nil
+      response
     end
 
     ##
@@ -1223,7 +1287,7 @@ module IBMWatson
     #   for the instance of the service that owns a model to list information about it.
     #
     #   **See also:** [Listing custom language
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/language-models.html#listModels-language).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
@@ -1248,70 +1312,31 @@ module IBMWatson
     end
 
     ##
-    # @!method list_language_models(language: nil)
-    # List custom language models.
-    # Lists information about all custom language models that are owned by an instance
-    #   of the service. Use the `language` parameter to see all custom language models for
-    #   the specified language. Omit the parameter to see all custom language models for
-    #   all languages. You must use credentials for the instance of the service that owns
-    #   a model to list information about it.
-    #
-    #   **See also:** [Listing custom language
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/language-models.html#listModels-language).
-    # @param language [String] The identifier of the language for which custom language or custom acoustic models
-    #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
-    #   language or custom acoustic models that are owned by the requesting credentials.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_language_models(language: nil)
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_language_models")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "language" => language
-      }
-
-      method_url = "/v1/customizations"
-
-      response = request(
-        method: "GET",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      response
-    end
-
-    ##
-    # @!method reset_language_model(customization_id:)
-    # Reset a custom language model.
-    # Resets a custom language model by removing all corpora, grammars, and words from
-    #   the model. Resetting a custom language model initializes the model to its state
-    #   when it was first created. Metadata such as the name and language of the model are
-    #   preserved, but the model's words resource is removed and must be re-created. You
-    #   must use credentials for the instance of the service that owns a model to reset
-    #   it.
+    # @!method delete_language_model(customization_id:)
+    # Delete a custom language model.
+    # Deletes an existing custom language model. The custom model cannot be deleted if
+    #   another request, such as adding a corpus or grammar to the model, is currently
+    #   being processed. You must use credentials for the instance of the service that
+    #   owns a model to delete it.
     #
-    #   **See also:** [Resetting a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-models.html#resetModel-language).
+    #   **See also:** [Deleting a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageLanguageModels#deleteModel-language).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
     # @return [nil]
-    def reset_language_model(customization_id:)
+    def delete_language_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "reset_language_model")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "delete_language_model")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/customizations/%s/reset" % [ERB::Util.url_encode(customization_id)]
+      method_url = "/v1/customizations/%s" % [ERB::Util.url_encode(customization_id)]
 
       request(
-        method: "POST",
+        method: "DELETE",
         url: method_url,
         headers: headers,
         accept_json: true
@@ -1342,15 +1367,16 @@ module IBMWatson
     #   and ready to use. The service cannot accept subsequent training requests or
     #   requests to add new resources until the existing request completes.
     #
-    #   Training can fail to start for the following reasons:
+    #   **See also:** [Train the custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-languageCreate#trainModel-language).
+    #
+    #
+    #   ### Training failures
+    #
+    #    Training can fail to start for the following reasons:
     #   * The service is currently handling another request for the custom model, such as
     #   another training request or a request to add a corpus or grammar to the model.
     #   * No training data have been added to the custom model.
-    #   * One or more words that were added to the custom model have invalid sounds-like
-    #   pronunciations that you must fix.
-    #
-    #   **See also:** [Train the custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-create.html#trainModel-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.
@@ -1376,7 +1402,7 @@ 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.
-    # @return [nil]
+    # @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?
 
@@ -1392,13 +1418,48 @@ module IBMWatson
 
       method_url = "/v1/customizations/%s/train" % [ERB::Util.url_encode(customization_id)]
 
-      request(
+      response = request(
         method: "POST",
         url: method_url,
         headers: headers,
         params: params,
         accept_json: true
       )
+      response
+    end
+
+    ##
+    # @!method reset_language_model(customization_id:)
+    # Reset a custom language model.
+    # Resets a custom language model by removing all corpora, grammars, and words from
+    #   the model. Resetting a custom language model initializes the model to its state
+    #   when it was first created. Metadata such as the name and language of the model are
+    #   preserved, but the model's words resource is removed and must be re-created. You
+    #   must use credentials for the instance of the service that owns a model to reset
+    #   it.
+    #
+    #   **See also:** [Resetting a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageLanguageModels#resetModel-language).
+    # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
+    # @return [nil]
+    def reset_language_model(customization_id:)
+      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "reset_language_model")
+      headers.merge!(sdk_headers)
+
+      method_url = "/v1/customizations/%s/reset" % [ERB::Util.url_encode(customization_id)]
+
+      request(
+        method: "POST",
+        url: method_url,
+        headers: headers,
+        accept_json: true
+      )
       nil
     end
 
@@ -1422,7 +1483,7 @@ module IBMWatson
     #   subsequent requests for the model until the upgrade completes.
     #
     #   **See also:** [Upgrading a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/custom-upgrade.html#upgradeLanguage).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-customUpgrade#upgradeLanguage).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
@@ -1449,6 +1510,39 @@ module IBMWatson
     # Custom corpora
     #########################
 
+    ##
+    # @!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.
+    #
+    #   **See also:** [Listing corpora for a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageCorpora#listCorpora).
+    # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_corpora(customization_id:)
+      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_corpora")
+      headers.merge!(sdk_headers)
+
+      method_url = "/v1/customizations/%s/corpora" % [ERB::Util.url_encode(customization_id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        accept_json: true
+      )
+      response
+    end
+
     ##
     # @!method add_corpus(customization_id:, corpus_name:, corpus_file:, allow_overwrite: nil)
     # Add a corpus.
@@ -1488,15 +1582,15 @@ module IBMWatson
     #
     #   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 30 thousand custom (OOV) words to a model. This includes words
+    #   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:**
     #   * [Working with
-    #   corpora](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#workingCorpora)
-    #   * [Add corpora to the custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-create.html#addCorpora).
+    #   corpora](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#workingCorpora)
+    #   * [Add a corpus to the custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-languageCreate#addCorpus).
     # @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.
@@ -1516,7 +1610,7 @@ module IBMWatson
     #   Make sure that you know the character encoding of the file. You must use that
     #   encoding when working with the words in the custom language model. For more
     #   information, see [Character
-    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
     #
     #
     #   With the `curl` command, use the `--data-binary` option to upload the file for the
@@ -1561,6 +1655,42 @@ module IBMWatson
       nil
     end
 
+    ##
+    # @!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.
+    #
+    #   **See also:** [Listing corpora for a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageCorpora#listCorpora).
+    # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
+    #   the request. You must make the request with credentials for the instance of the
+    #   service that owns the custom model.
+    # @param corpus_name [String] The name of the corpus for the custom language model.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def get_corpus(customization_id:, corpus_name:)
+      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
+
+      raise ArgumentError.new("corpus_name must be provided") if corpus_name.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "get_corpus")
+      headers.merge!(sdk_headers)
+
+      method_url = "/v1/customizations/%s/corpora/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(corpus_name)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        accept_json: true
+      )
+      response
+    end
+
     ##
     # @!method delete_corpus(customization_id:, corpus_name:)
     # Delete a corpus.
@@ -1574,7 +1704,7 @@ module IBMWatson
     #   corpora.
     #
     #   **See also:** [Deleting a corpus from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-corpora.html#deleteCorpus).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageCorpora#deleteCorpus).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
@@ -1600,78 +1730,154 @@ module IBMWatson
       )
       nil
     end
+    #########################
+    # Custom words
+    #########################
 
     ##
-    # @!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.
+    # @!method list_words(customization_id:, word_type: nil, sort: nil)
+    # 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
+    #   service that owns a model to list information about its words.
     #
-    #   **See also:** [Listing corpora for a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-corpora.html#listCorpora).
+    #   **See also:** [Listing words from a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageWords#listWords).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
-    # @param corpus_name [String] The name of the corpus for the custom language model.
+    # @param word_type [String] The type of words to be listed from the custom language model's words resource:
+    #   * `all` (the default) shows all words.
+    #   * `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.
+    # @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
+    #   are sorted in ascending alphabetical order. For alphabetical ordering, the
+    #   lexicographical precedence is numeric values, uppercase letters, and lowercase
+    #   letters. For count ordering, values with the same count are ordered
+    #   alphabetically. With the `curl` command, URL encode the `+` symbol as `%2B`.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def get_corpus(customization_id:, corpus_name:)
+    def list_words(customization_id:, word_type: nil, sort: nil)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
-      raise ArgumentError.new("corpus_name must be provided") if corpus_name.nil?
-
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "get_corpus")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_words")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/customizations/%s/corpora/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(corpus_name)]
+      params = {
+        "word_type" => word_type,
+        "sort" => sort
+      }
+
+      method_url = "/v1/customizations/%s/words" % [ERB::Util.url_encode(customization_id)]
 
       response = request(
         method: "GET",
         url: method_url,
         headers: headers,
+        params: params,
         accept_json: true
       )
       response
     end
 
     ##
-    # @!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.
+    # @!method add_words(customization_id:, words:)
+    # Add custom words.
+    # Adds one or more custom words 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
+    #   additional words or to modify existing words 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.
     #
-    #   **See also:** [Listing corpora for a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-corpora.html#listCorpora).
+    #   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.
+    #
+    #   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.
+    #   * 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™`.
+    #
+    #   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 with the input data, it returns a failure code and
+    #   does not add any of the words to the words resource.
+    #
+    #   The call returns an HTTP 201 response code if the input data is valid. It then
+    #   asynchronously processes the words to add them to the model's words resource. The
+    #   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.
+    #
+    #
+    #   **See also:**
+    #   * [Working with custom
+    #   words](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
+    #   * [Add words to the custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-languageCreate#addWords).
     # @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.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_corpora(customization_id:)
+    # @param words [Array[CustomWord]] An array of `CustomWord` objects that provides information about each custom word
+    #   that is to be added to or updated in the custom language model.
+    # @return [nil]
+    def add_words(customization_id:, words:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
+      raise ArgumentError.new("words must be provided") if words.nil?
+
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_corpora")
-      headers.merge!(sdk_headers)
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "add_words")
+      headers.merge!(sdk_headers)
+
+      data = {
+        "words" => words
+      }
 
-      method_url = "/v1/customizations/%s/corpora" % [ERB::Util.url_encode(customization_id)]
+      method_url = "/v1/customizations/%s/words" % [ERB::Util.url_encode(customization_id)]
 
-      response = request(
-        method: "GET",
+      request(
+        method: "POST",
         url: method_url,
         headers: headers,
+        json: data,
         accept_json: true
       )
-      response
+      nil
     end
-    #########################
-    # Custom words
-    #########################
 
     ##
     # @!method add_word(customization_id:, word_name:, word: nil, sounds_like: nil, display_as: nil)
@@ -1680,7 +1886,7 @@ module IBMWatson
     #   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 30 thousand custom (OOV) words. This includes words that the
+    #   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
@@ -1709,9 +1915,9 @@ module IBMWatson
     #
     #   **See also:**
     #   * [Working with custom
-    #   words](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#workingWords)
+    #   words](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#workingWords)
     #   * [Add words to the custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-create.html#addWords).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-languageCreate#addWords).
     # @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.
@@ -1719,7 +1925,7 @@ module IBMWatson
     #   not include spaces in the word. Use a `-` (dash) or `_` (underscore) to connect
     #   the tokens of compound words. URL-encode the word if it includes non-ASCII
     #   characters. For more information, see [Character
-    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/services/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.
@@ -1770,94 +1976,40 @@ module IBMWatson
     end
 
     ##
-    # @!method add_words(customization_id:, words:)
-    # Add custom words.
-    # Adds one or more custom words 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
-    #   additional words or to modify existing words in the words resource. The words
-    #   resource for a model can contain a maximum of 30 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 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.
-    #
-    #   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.
-    #   * 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™`.
-    #
-    #   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 with the input data, it returns a failure code and
-    #   does not add any of the words to the words resource.
-    #
-    #   The call returns an HTTP 201 response code if the input data is valid. It then
-    #   asynchronously processes the words to add them to the model's words resource. The
-    #   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.
-    #
+    # @!method get_word(customization_id:, word_name:)
+    # Get a custom word.
+    # Gets information about a custom word from a custom language model. You must use
+    #   credentials for the instance of the service that owns a model to list information
+    #   about its words.
     #
-    #   **See also:**
-    #   * [Working with custom
-    #   words](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#workingWords)
-    #   * [Add words to the custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-create.html#addWords).
+    #   **See also:** [Listing words from a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageWords#listWords).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
-    # @param words [Array[CustomWord]] An array of `CustomWord` objects that provides information about each custom word
-    #   that is to be added to or updated in the custom language model.
-    # @return [nil]
-    def add_words(customization_id:, words:)
+    # @param word_name [String] The custom word that is to be read from the custom language model. URL-encode the
+    #   word if it includes non-ASCII characters. For more information, see [Character
+    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def get_word(customization_id:, word_name:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
-      raise ArgumentError.new("words must be provided") if words.nil?
+      raise ArgumentError.new("word_name must be provided") if word_name.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "add_words")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "get_word")
       headers.merge!(sdk_headers)
 
-      data = {
-        "words" => words
-      }
-
-      method_url = "/v1/customizations/%s/words" % [ERB::Util.url_encode(customization_id)]
+      method_url = "/v1/customizations/%s/words/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(word_name)]
 
-      request(
-        method: "POST",
+      response = request(
+        method: "GET",
         url: method_url,
         headers: headers,
-        json: data,
         accept_json: true
       )
-      nil
+      response
     end
 
     ##
@@ -1872,13 +2024,13 @@ module IBMWatson
     #   instance of the service that owns a model to delete its words.
     #
     #   **See also:** [Deleting a word from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-words.html#deleteWord).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageWords#deleteWord).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
     # @param word_name [String] The custom word that is to be deleted from the custom language model. URL-encode
     #   the word if it includes non-ASCII characters. For more information, see [Character
-    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#charEncoding).
+    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-corporaWords#charEncoding).
     # @return [nil]
     def delete_word(customization_id:, word_name:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -1900,100 +2052,42 @@ module IBMWatson
       )
       nil
     end
+    #########################
+    # Custom grammars
+    #########################
 
     ##
-    # @!method get_word(customization_id:, word_name:)
-    # Get a custom word.
-    # Gets information about a custom word from a custom language model. 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
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-words.html#listWords).
-    # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
-    #   the request. You must make the request with credentials for the instance of the
-    #   service that owns the custom model.
-    # @param word_name [String] The custom word that is to be read from the custom language model. URL-encode the
-    #   word if it includes non-ASCII characters. For more information, see [Character
-    #   encoding](https://cloud.ibm.com/docs/services/speech-to-text/language-resource.html#charEncoding).
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def get_word(customization_id:, word_name:)
-      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
-
-      raise ArgumentError.new("word_name must be provided") if word_name.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "get_word")
-      headers.merge!(sdk_headers)
-
-      method_url = "/v1/customizations/%s/words/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(word_name)]
-
-      response = request(
-        method: "GET",
-        url: method_url,
-        headers: headers,
-        accept_json: true
-      )
-      response
-    end
-
-    ##
-    # @!method list_words(customization_id:, word_type: nil, sort: nil)
-    # 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
-    #   service that owns a model to list information about its words.
+    # @!method list_grammars(customization_id:)
+    # List grammars.
+    # 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.
     #
-    #   **See also:** [Listing words from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/language-words.html#listWords).
+    #   **See also:** [Listing grammars from a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
-    # @param word_type [String] The type of words to be listed from the custom language model's words resource:
-    #   * `all` (the default) shows all words.
-    #   * `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.
-    # @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
-    #   are sorted in ascending alphabetical order. For alphabetical ordering, the
-    #   lexicographical precedence is numeric values, uppercase letters, and lowercase
-    #   letters. For count ordering, values with the same count are ordered
-    #   alphabetically. With the `curl` command, URL encode the `+` symbol as `%2B`.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_words(customization_id:, word_type: nil, sort: nil)
+    def list_grammars(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_words")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_grammars")
       headers.merge!(sdk_headers)
 
-      params = {
-        "word_type" => word_type,
-        "sort" => sort
-      }
-
-      method_url = "/v1/customizations/%s/words" % [ERB::Util.url_encode(customization_id)]
+      method_url = "/v1/customizations/%s/grammars" % [ERB::Util.url_encode(customization_id)]
 
       response = request(
         method: "GET",
         url: method_url,
         headers: headers,
-        params: params,
         accept_json: true
       )
       response
     end
-    #########################
-    # Custom grammars
-    #########################
 
     ##
     # @!method add_grammar(customization_id:, grammar_name:, grammar_file:, content_type:, allow_overwrite: nil)
@@ -2030,13 +2124,14 @@ module IBMWatson
     #
     #   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 30 thousand OOV words to a model. This includes words that the
+    #   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.
     #
     #   **See also:**
-    #   * [Working with grammars](https://cloud.ibm.com/docs/services/speech-to-text/)
-    #   * [Add grammars to the custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/).
+    #   * [Understanding
+    #   grammars](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-grammarUnderstand#grammarUnderstand)
+    #   * [Add a grammar to the custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-grammarAdd#addGrammar).
     # @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.
@@ -2054,6 +2149,9 @@ module IBMWatson
     #   Using any other encoding can lead to issues when compiling the grammar or to
     #   unexpected results in decoding. The service ignores an encoding that is specified
     #   in the header of the grammar.
+    #
+    #   With the `curl` command, use the `--data-binary` option to upload the file for the
+    #   request.
     # @param content_type [String] The format (MIME type) of the grammar file:
     #   * `application/srgs` for Augmented Backus-Naur Form (ABNF), which uses a
     #   plain-text representation that is similar to traditional BNF grammars.
@@ -2098,45 +2196,6 @@ module IBMWatson
       nil
     end
 
-    ##
-    # @!method delete_grammar(customization_id:, grammar_name:)
-    # Delete a grammar.
-    # 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.
-    #
-    #   **See also:** [Deleting a grammar from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/).
-    # @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 grammar_name [String] The name of the grammar for the custom language model.
-    # @return [nil]
-    def delete_grammar(customization_id:, grammar_name:)
-      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
-
-      raise ArgumentError.new("grammar_name must be provided") if grammar_name.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "delete_grammar")
-      headers.merge!(sdk_headers)
-
-      method_url = "/v1/customizations/%s/grammars/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(grammar_name)]
-
-      request(
-        method: "DELETE",
-        url: method_url,
-        headers: headers,
-        accept_json: true
-      )
-      nil
-    end
-
     ##
     # @!method get_grammar(customization_id:, grammar_name:)
     # Get a grammar.
@@ -2146,7 +2205,7 @@ module IBMWatson
     #   model to list its grammars.
     #
     #   **See also:** [Listing grammars from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
     # @param customization_id [String] The customization ID (GUID) of the custom language model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
@@ -2174,36 +2233,42 @@ module IBMWatson
     end
 
     ##
-    # @!method list_grammars(customization_id:)
-    # List grammars.
-    # 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.
+    # @!method delete_grammar(customization_id:, grammar_name:)
+    # Delete a grammar.
+    # 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.
     #
-    #   **See also:** [Listing grammars from a custom language
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/).
+    #   **See also:** [Deleting a grammar from a custom language
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageGrammars#deleteGrammar).
     # @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.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_grammars(customization_id:)
+    # @param grammar_name [String] The name of the grammar for the custom language model.
+    # @return [nil]
+    def delete_grammar(customization_id:, grammar_name:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
+      raise ArgumentError.new("grammar_name must be provided") if grammar_name.nil?
+
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_grammars")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "delete_grammar")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/customizations/%s/grammars" % [ERB::Util.url_encode(customization_id)]
+      method_url = "/v1/customizations/%s/grammars/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(grammar_name)]
 
-      response = request(
-        method: "GET",
+      request(
+        method: "DELETE",
         url: method_url,
         headers: headers,
         accept_json: true
       )
-      response
+      nil
     end
     #########################
     # Custom acoustic models
@@ -2218,7 +2283,7 @@ module IBMWatson
     #   it.
     #
     #   **See also:** [Create a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-create.html#createModel-acoustic).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-acoustic#createModel-acoustic).
     # @param name [String] A user-defined name for the new custom acoustic model. Use a name that is unique
     #   among all custom acoustic models that you own. Use a localized name that matches
     #   the language of the custom model. Use a name that describes the acoustic
@@ -2230,7 +2295,7 @@ module IBMWatson
     #
     #   To determine whether a base model supports acoustic model customization, refer to
     #   [Language support for
-    #   customization](https://cloud.ibm.com/docs/services/speech-to-text/custom.html#languageSupport).
+    #   customization](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-customization#languageSupport).
     # @param description [String] A description of the new custom acoustic model. Use a localized description that
     #   matches the language of the custom model.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
@@ -2263,36 +2328,40 @@ module IBMWatson
     end
 
     ##
-    # @!method delete_acoustic_model(customization_id:)
-    # Delete a custom acoustic model.
-    # Deletes an existing custom acoustic model. The custom model cannot be deleted if
-    #   another request, such as adding an audio resource to the model, is currently being
-    #   processed. You must use credentials for the instance of the service that owns a
-    #   model to delete it.
+    # @!method list_acoustic_models(language: nil)
+    # List custom acoustic models.
+    # Lists information about all custom acoustic models that are owned by an instance
+    #   of the service. Use the `language` parameter to see all custom acoustic models for
+    #   the specified language. Omit the parameter to see all custom acoustic models for
+    #   all languages. You must use credentials for the instance of the service that owns
+    #   a model to list information about it.
     #
-    #   **See also:** [Deleting a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-models.html#deleteModel-acoustic).
-    # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with credentials for the instance of the
-    #   service that owns the custom model.
-    # @return [nil]
-    def delete_acoustic_model(customization_id:)
-      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
-
+    #   **See also:** [Listing custom acoustic
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAcousticModels#listModels-acoustic).
+    # @param language [String] The identifier of the language for which custom language or custom acoustic models
+    #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
+    #   language or custom acoustic models that are owned by the requesting credentials.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_acoustic_models(language: nil)
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "delete_acoustic_model")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_acoustic_models")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/acoustic_customizations/%s" % [ERB::Util.url_encode(customization_id)]
+      params = {
+        "language" => language
+      }
 
-      request(
-        method: "DELETE",
+      method_url = "/v1/acoustic_customizations"
+
+      response = request(
+        method: "GET",
         url: method_url,
         headers: headers,
+        params: params,
         accept_json: true
       )
-      nil
+      response
     end
 
     ##
@@ -2302,7 +2371,7 @@ module IBMWatson
     #   for the instance of the service that owns a model to list information about it.
     #
     #   **See also:** [Listing custom acoustic
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-models.html#listModels-acoustic).
+    #   models](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAcousticModels#listModels-acoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
@@ -2327,69 +2396,31 @@ module IBMWatson
     end
 
     ##
-    # @!method list_acoustic_models(language: nil)
-    # List custom acoustic models.
-    # Lists information about all custom acoustic models that are owned by an instance
-    #   of the service. Use the `language` parameter to see all custom acoustic models for
-    #   the specified language. Omit the parameter to see all custom acoustic models for
-    #   all languages. You must use credentials for the instance of the service that owns
-    #   a model to list information about it.
-    #
-    #   **See also:** [Listing custom acoustic
-    #   models](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-models.html#listModels-acoustic).
-    # @param language [String] The identifier of the language for which custom language or custom acoustic models
-    #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
-    #   language or custom acoustic models that are owned by the requesting credentials.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_acoustic_models(language: nil)
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_acoustic_models")
-      headers.merge!(sdk_headers)
-
-      params = {
-        "language" => language
-      }
-
-      method_url = "/v1/acoustic_customizations"
-
-      response = request(
-        method: "GET",
-        url: method_url,
-        headers: headers,
-        params: params,
-        accept_json: true
-      )
-      response
-    end
-
-    ##
-    # @!method reset_acoustic_model(customization_id:)
-    # Reset a custom acoustic model.
-    # Resets a custom acoustic model by removing all audio resources from the model.
-    #   Resetting a custom acoustic model initializes the model to its state when it was
-    #   first created. Metadata such as the name and language of the model are preserved,
-    #   but the model's audio resources are removed and must be re-created. You must use
-    #   credentials for the instance of the service that owns a model to reset it.
+    # @!method delete_acoustic_model(customization_id:)
+    # Delete a custom acoustic model.
+    # Deletes an existing custom acoustic model. The custom model cannot be deleted if
+    #   another request, such as adding an audio resource to the model, is currently being
+    #   processed. You must use credentials for the instance of the service that owns a
+    #   model to delete it.
     #
-    #   **See also:** [Resetting a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-models.html#resetModel-acoustic).
+    #   **See also:** [Deleting a custom acoustic
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAcousticModels#deleteModel-acoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
     # @return [nil]
-    def reset_acoustic_model(customization_id:)
+    def delete_acoustic_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "reset_acoustic_model")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "delete_acoustic_model")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/acoustic_customizations/%s/reset" % [ERB::Util.url_encode(customization_id)]
+      method_url = "/v1/acoustic_customizations/%s" % [ERB::Util.url_encode(customization_id)]
 
       request(
-        method: "POST",
+        method: "DELETE",
         url: method_url,
         headers: headers,
         accept_json: true
@@ -2431,18 +2462,23 @@ module IBMWatson
     #   files. Both of the custom models must be based on the same version of the same
     #   base model for training to succeed.
     #
-    #   Training can fail to start for the following reasons:
+    #   **See also:**
+    #   * [Train the custom acoustic
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-acoustic#trainModel-acoustic)
+    #   * [Using custom acoustic and custom language models
+    #   together](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-useBoth#useBoth)
+    #
+    #
+    #   ### Training failures
+    #
+    #    Training can fail to start for the following reasons:
     #   * The service is currently handling another request for the custom model, such as
     #   another training request or a request to add audio resources to the model.
-    #   * The custom model contains less than 10 minutes or more than 100 hours of audio
+    #   * The custom model contains less than 10 minutes or more than 200 hours of audio
     #   data.
-    #   * One or more of the custom model's audio resources is invalid.
     #   * You passed an incompatible custom language model with the
     #   `custom_language_model_id` query parameter. Both custom models must be based on
     #   the same version of the same base model.
-    #
-    #   **See also:** [Train the custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-create.html#trainModel-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.
@@ -2453,7 +2489,7 @@ module IBMWatson
     #   language model must be based on the same version of the same base model as the
     #   custom acoustic model. The credentials specified with the request must own both
     #   custom models.
-    # @return [nil]
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def train_acoustic_model(customization_id:, custom_language_model_id: nil)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
@@ -2468,13 +2504,47 @@ module IBMWatson
 
       method_url = "/v1/acoustic_customizations/%s/train" % [ERB::Util.url_encode(customization_id)]
 
-      request(
+      response = request(
         method: "POST",
         url: method_url,
         headers: headers,
         params: params,
         accept_json: true
       )
+      response
+    end
+
+    ##
+    # @!method reset_acoustic_model(customization_id:)
+    # Reset a custom acoustic model.
+    # Resets a custom acoustic model by removing all audio resources from the model.
+    #   Resetting a custom acoustic model initializes the model to its state when it was
+    #   first created. Metadata such as the name and language of the model are preserved,
+    #   but the model's audio resources are removed and must be re-created. You must use
+    #   credentials for the instance of the service that owns a model to reset it.
+    #
+    #   **See also:** [Resetting a custom acoustic
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAcousticModels#resetModel-acoustic).
+    # @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.
+    # @return [nil]
+    def reset_acoustic_model(customization_id:)
+      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "reset_acoustic_model")
+      headers.merge!(sdk_headers)
+
+      method_url = "/v1/acoustic_customizations/%s/reset" % [ERB::Util.url_encode(customization_id)]
+
+      request(
+        method: "POST",
+        url: method_url,
+        headers: headers,
+        accept_json: true
+      )
       nil
     end
 
@@ -2505,7 +2575,7 @@ module IBMWatson
     #   acoustic model was not trained with a custom language model.
     #
     #   **See also:** [Upgrading a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/custom-upgrade.html#upgradeAcoustic).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-customUpgrade#upgradeAcoustic).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
@@ -2518,7 +2588,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/services/speech-to-text/custom-upgrade.html#upgradeAcoustic).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-customUpgrade#upgradeAcoustic).
     # @return [nil]
     def upgrade_acoustic_model(customization_id:, custom_language_model_id: nil, force: nil)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -2548,6 +2618,41 @@ module IBMWatson
     # Custom audio resources
     #########################
 
+    ##
+    # @!method list_audio(customization_id:)
+    # List audio resources.
+    # Lists information about all audio resources from a custom acoustic model. The
+    #   information includes the name of the resource and information about its audio
+    #   data, such as its duration. It also includes the status of the audio resource,
+    #   which is important for checking the service's analysis of the resource in response
+    #   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.
+    #
+    #   **See also:** [Listing audio resources for a custom acoustic
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAudio#listAudio).
+    # @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.
+    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
+    def list_audio(customization_id:)
+      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
+
+      headers = {
+      }
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_audio")
+      headers.merge!(sdk_headers)
+
+      method_url = "/v1/acoustic_customizations/%s/audio" % [ERB::Util.url_encode(customization_id)]
+
+      response = request(
+        method: "GET",
+        url: method_url,
+        headers: headers,
+        accept_json: true
+      )
+      response
+    end
+
     ##
     # @!method add_audio(customization_id:, audio_name:, audio_resource:, contained_content_type: nil, allow_overwrite: nil, content_type: nil)
     # Add an audio resource.
@@ -2566,7 +2671,7 @@ module IBMWatson
     #   You can use this method to add any number of audio resources to a custom model by
     #   calling the method once for each audio or archive file. But the addition of one
     #   audio resource must be fully complete before you can add another. You must add a
-    #   minimum of 10 minutes and a maximum of 100 hours of audio that includes speech,
+    #   minimum of 10 minutes and a maximum of 200 hours of audio that includes speech,
     #   not just silence, to a custom acoustic model before you can train it. No audio
     #   resource, audio- or archive-type, can be larger than 100 MB. To add an audio
     #   resource that has the same name as an existing audio resource, set the
@@ -2588,7 +2693,7 @@ module IBMWatson
     #   every few seconds until it becomes `ok`.
     #
     #   **See also:** [Add audio to the custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-create.html#addAudio).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-acoustic#addAudio).
     #
     #
     #   ### Content types for audio-type resources
@@ -2622,7 +2727,8 @@ module IBMWatson
     #   service labels the audio file as `invalid`.
     #
     #    **See also:** [Audio
-    #   formats](https://cloud.ibm.com/docs/services/speech-to-text/audio-formats.html).
+    #   formats](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
+    #
     #
     #   ### Content types for archive-type resources
     #
@@ -2669,6 +2775,9 @@ module IBMWatson
     #   custom model.
     # @param audio_resource [String] The audio resource that is to be added to the custom acoustic model, an individual
     #   audio file or an archive file.
+    #
+    #   With the `curl` command, use the `--data-binary` option to upload the file for the
+    #   request.
     # @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`
@@ -2729,45 +2838,6 @@ module IBMWatson
       nil
     end
 
-    ##
-    # @!method delete_audio(customization_id:, audio_name:)
-    # Delete an audio resource.
-    # Deletes an existing audio resource from a custom acoustic model. Deleting an
-    #   archive-type audio resource removes the entire archive of files; the current
-    #   interface does 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 must use credentials for the instance of the service that owns a model to
-    #   delete its audio resources.
-    #
-    #   **See also:** [Deleting an audio resource from a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-audio.html#deleteAudio).
-    # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
-    #   the request. You must make the request with credentials for the instance of the
-    #   service that owns the custom model.
-    # @param audio_name [String] The name of the audio resource for the custom acoustic model.
-    # @return [nil]
-    def delete_audio(customization_id:, audio_name:)
-      raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
-
-      raise ArgumentError.new("audio_name must be provided") if audio_name.nil?
-
-      headers = {
-      }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "delete_audio")
-      headers.merge!(sdk_headers)
-
-      method_url = "/v1/acoustic_customizations/%s/audio/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(audio_name)]
-
-      request(
-        method: "DELETE",
-        url: method_url,
-        headers: headers,
-        accept_json: true
-      )
-      nil
-    end
-
     ##
     # @!method get_audio(customization_id:, audio_name:)
     # Get an audio resource.
@@ -2793,7 +2863,7 @@ module IBMWatson
     #   its audio resources.
     #
     #   **See also:** [Listing audio resources for a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-audio.html#listAudio).
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAudio#listAudio).
     # @param customization_id [String] The customization ID (GUID) of the custom acoustic model that is to be used for
     #   the request. You must make the request with credentials for the instance of the
     #   service that owns the custom model.
@@ -2821,38 +2891,42 @@ module IBMWatson
     end
 
     ##
-    # @!method list_audio(customization_id:)
-    # List audio resources.
-    # Lists information about all audio resources from a custom acoustic model. The
-    #   information includes the name of the resource and information about its audio
-    #   data, such as its duration. It also includes the status of the audio resource,
-    #   which is important for checking the service's analysis of the resource in response
-    #   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.
+    # @!method delete_audio(customization_id:, audio_name:)
+    # Delete an audio resource.
+    # Deletes an existing audio resource from a custom acoustic model. Deleting an
+    #   archive-type audio resource removes the entire archive of files; the current
+    #   interface does 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 must use credentials for the instance of the service that owns a model to
+    #   delete its audio resources.
     #
-    #   **See also:** [Listing audio resources for a custom acoustic
-    #   model](https://cloud.ibm.com/docs/services/speech-to-text/acoustic-audio.html#listAudio).
+    #   **See also:** [Deleting an audio resource from a custom acoustic
+    #   model](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-manageAudio#deleteAudio).
     # @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.
-    # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_audio(customization_id:)
+    # @param audio_name [String] The name of the audio resource for the custom acoustic model.
+    # @return [nil]
+    def delete_audio(customization_id:, audio_name:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
+      raise ArgumentError.new("audio_name must be provided") if audio_name.nil?
+
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "list_audio")
+      sdk_headers = Common.new.get_sdk_headers("speech_to_text", "V1", "delete_audio")
       headers.merge!(sdk_headers)
 
-      method_url = "/v1/acoustic_customizations/%s/audio" % [ERB::Util.url_encode(customization_id)]
+      method_url = "/v1/acoustic_customizations/%s/audio/%s" % [ERB::Util.url_encode(customization_id), ERB::Util.url_encode(audio_name)]
 
-      response = request(
-        method: "GET",
+      request(
+        method: "DELETE",
         url: method_url,
         headers: headers,
         accept_json: true
       )
-      response
+      nil
     end
     #########################
     # User data
@@ -2871,7 +2945,7 @@ module IBMWatson
     #   with a request that passes the data.
     #
     #   **See also:** [Information
-    #   security](https://cloud.ibm.com/docs/services/speech-to-text/information-security.html).
+    #   security](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-information-security#information-security).
     # @param customer_id [String] The customer ID for which all data is to be deleted.
     # @return [nil]
     def delete_user_data(customer_id:)