ibm_watson 1.4.0 → 2.0.1

data/lib/ibm_watson/personality_insights_v3.rb

@@ -13,12 +13,25 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
-# The IBM Watson™ Personality Insights service enables applications to derive
-# insights from social media, enterprise data, or other digital communications. The
-# service uses linguistic analytics to infer individuals' intrinsic personality
-# characteristics, including Big Five, Needs, and Values, from digital communications such
-# as email, text messages, tweets, and forum posts.
+#
+# IBM OpenAPI SDK Code Generator Version: 3.19.0-be3b4618-20201113-200858
+#
+# IBM® will begin sunsetting IBM Watson™ Personality Insights on 1 December
+# 2020. For a period of one year from this date, you will still be able to use Watson
+# Personality Insights. However, as of 1 December 2021, the offering will no longer be
+# available.<br/><br/>As an alternative, we encourage you to consider migrating to IBM
+# Watson&trade; Natural Language Understanding, a service on IBM Cloud&reg; that uses deep
+# learning to extract data and insights from text such as keywords, categories, sentiment,
+# emotion, and syntax to provide insights for your business or industry. For more
+# information, see [About Natural Language
+# Understanding](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-about).
+# {: deprecated}
+#
+# The IBM Watson Personality Insights service enables applications to derive insights from
+# social media, enterprise data, or other digital communications. The service uses
+# linguistic analytics to infer individuals' intrinsic personality characteristics,
+# including Big Five, Needs, and Values, from digital communications such as email, text
+# messages, tweets, and forum posts.
 #
 # The service can automatically infer, from potentially noisy social media, portraits of
 # individuals that reflect their personality characteristics. The service can infer
@@ -48,34 +61,28 @@ module IBMWatson
   class PersonalityInsightsV3 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "personality_insights"
-    DEFAULT_SERVICE_URL = "https://gateway.watsonplatform.net/personality-insights/api"
+    DEFAULT_SERVICE_URL = "https://api.us-south.personality-insights.watson.cloud.ibm.com"
+    attr_accessor :version
     ##
     # @!method initialize(args)
     # Construct a new client for the Personality Insights service.
     #
     # @param args [Hash] The args to initialize with
-    # @option args version [String] The API version date to use with the service, in
-    #   "YYYY-MM-DD" format. Whenever the API is changed in a backwards
-    #   incompatible way, a new minor version of the API is released.
-    #   The service uses the API version for the date you specify, or
-    #   the most recent version before that date. Note that you should
-    #   not programmatically specify the current date at runtime, in
-    #   case the API has been updated since your application's release.
-    #   Instead, specify a version date that is compatible with your
-    #   application, and don't change it until your application is
-    #   ready for a later version.
+    # @option args version [String] Release date of the version of the API you want to use. Specify dates in
+    #   YYYY-MM-DD format. The current version is `2017-10-13`.
     # @option args service_url [String] The base service URL to use when contacting the service.
     #   The base service_url may differ between IBM Cloud regions.
     # @option args authenticator [Object] The Authenticator instance to be configured for this service.
     # @option args service_name [String] The name of the service to configure. Will be used as the key to load
     #   any external configuration, if applicable.
     def initialize(args = {})
+      warn "On 1 December 2021, Personality Insights will no longer be available. For more information, see https://github.com/watson-developer-cloud/ruby-sdk/tree/master#personality-insights-deprecation."
       @__async_initialized__ = false
       defaults = {}
-      defaults[:version] = nil
       defaults[:service_url] = DEFAULT_SERVICE_URL
       defaults[:service_name] = DEFAULT_SERVICE_NAME
       defaults[:authenticator] = nil
+      defaults[:version] = nil
       user_service_url = args[:service_url] unless args[:service_url].nil?
       args = defaults.merge(args)
       @version = args[:version]
@@ -170,6 +177,8 @@ module IBMWatson
     #   default, no consumption preferences are returned.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def profile(content:, accept:, content_type: nil, content_language: nil, accept_language: nil, raw_scores: nil, csv_headers: nil, consumption_preferences: nil)
+      raise ArgumentError.new("version must be provided") if version.nil?
+
       raise ArgumentError.new("content must be provided") if content.nil?
 
       raise ArgumentError.new("accept must be provided") if accept.nil?

data/lib/ibm_watson/speech_to_text_v1.rb

@@ -13,13 +13,15 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
-# The IBM® Speech to Text service provides APIs that use IBM's speech-recognition
-# capabilities to produce transcripts of spoken audio. The service can transcribe speech
-# from various languages and audio formats. In addition to basic transcription, the
-# service can produce detailed information about many different aspects of the audio. For
-# most languages, the service supports two sampling rates, broadband and narrowband. It
-# returns all JSON response content in the UTF-8 character set.
+#
+# IBM OpenAPI SDK Code Generator Version: 3.19.0-be3b4618-20201113-200858
+#
+# The IBM Watson™ Speech to Text service provides APIs that use IBM's
+# speech-recognition capabilities to produce transcripts of spoken audio. The service can
+# transcribe speech from various languages and audio formats. In addition to basic
+# transcription, the service can produce detailed information about many different aspects
+# of the audio. For most languages, the service supports two sampling rates, broadband and
+# narrowband. It returns all JSON response content in the UTF-8 character set.
 #
 # For speech recognition, the service supports synchronous and asynchronous HTTP
 # Representational State Transfer (REST) interfaces. It also supports a WebSocket
@@ -51,7 +53,7 @@ module IBMWatson
   class SpeechToTextV1 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "speech_to_text"
-    DEFAULT_SERVICE_URL = "https://stream.watsonplatform.net/speech-to-text/api"
+    DEFAULT_SERVICE_URL = "https://api.us-south.speech-to-text.watson.cloud.ibm.com"
     ##
     # @!method initialize(args)
     # Construct a new client for the Speech to Text service.
@@ -84,7 +86,8 @@ module IBMWatson
     # List models.
     # Lists all language models that are available for use with the service. The
     #   information includes the name of the model and its minimum sampling rate in Hertz,
-    #   among other things.
+    #   among other things. The ordering of the list of models can change from call to
+    #   call; do not rely on an alphabetized or static list of models.
     #
     #   **See also:** [Languages and
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models#models).
@@ -229,7 +232,7 @@ module IBMWatson
     #
     #   **See also:** [Making a multipart HTTP
     #   request](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-http#HTTP-multi).
-    # @param audio [String] The audio to transcribe.
+    # @param audio [File] The audio to transcribe.
     # @param content_type [String] The format (MIME type) of the audio. For more information about specifying an
     #   audio format, see **Audio formats (content types)** in the method description.
     # @param model [String] The identifier of the model that is to be used for the recognition request. See
@@ -335,11 +338,9 @@ module IBMWatson
     #   parameter to be `true`, regardless of whether you specify `false` for the
     #   parameter.
     #
-    #   **Note:** Applies to US English, German, Japanese, Korean, and Spanish (both
-    #   broadband and narrowband models) and UK English (narrowband model) transcription
-    #   only. To determine whether a language model supports speaker labels, you can also
-    #   use the **Get a model** method and check that the attribute `speaker_labels` is
-    #   set to `true`.
+    #   **Note:** Applies to US English, Australian English, German, Japanese, Korean, and
+    #   Spanish (both broadband and narrowband models) and UK English (narrowband model)
+    #   transcription only.
     #
     #   See [Speaker
     #   labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#speaker_labels).
@@ -488,7 +489,7 @@ module IBMWatson
     # @param customization_id [String] The GUID of a custom language model that is to be used with the request. The base model of the specified custom language model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom language model is used.
     # @param acoustic_customization_id [String] The GUID of a custom acoustic model that is to be used with the request. The base model of the specified custom acoustic model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom acoustic model is used.
     # @param language_customization_id [String] The GUID of a custom language model that is to be used with the request. The base model of the specified custom language model must match the model specified with the `model` parameter. You must make the request with service credentials created for the instance of the service that owns the custom model. By default, no custom language model is used.
-    # @param base_model_version [String] The version of the specified base `model` that is to be used for speech recognition. Multiple versions of a base model can exist when a model is updated for internal improvements. The parameter is intended primarily for use with custom models that have been upgraded for a new base model. The default value depends on whether the parameter is used with or without a custom model. For more information, see [Base model version](https://console.bluemix.net/docs/services/speech-to-text/input.html#version).
+    # @param base_model_version [String] The version of the specified base `model` that is to be used for speech recognition. Multiple versions of a base model can exist when a model is updated for internal improvements. The parameter is intended primarily for use with custom models that have been upgraded for a new base model. The default value depends on whether the parameter is used with or without a custom model. For more information, see [Base model version](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-input#version).
     # @param inactivity_timeout [Integer] The time in seconds after which, if only silence (no speech) is detected in submitted audio, the connection is closed with a 400 error. Useful for stopping audio submission from a live microphone when a user simply walks away. Use `-1` for infinity.
     # @param interim_results [Boolean] Send back non-final previews of each "sentence" as it is being processed. These results are ignored in text mode.
     # @param keywords [Array<String>] Array of keyword strings to spot in the audio. Each keyword string can include one or more tokens. Keywords are spotted only in the final hypothesis, not in interim results. If you specify any keywords, you must also specify a keywords threshold. Omit the parameter or specify an empty array if you do not need to spot keywords.
@@ -499,13 +500,13 @@ module IBMWatson
     # @param timestamps [Boolean] If `true`, time alignment for each word is returned.
     # @param profanity_filter [Boolean] If `true` (the default), filters profanity from all output except for keyword results by replacing inappropriate words with a series of asterisks. Set the parameter to `false` to return results with no censoring. Applies to US English transcription only.
     # @param smart_formatting [Boolean] If `true`, converts dates, times, series of digits and numbers, phone numbers, currency values, and Internet addresses into more readable, conventional representations in the final transcript of a recognition request. If `false` (the default), no formatting is performed. Applies to US English transcription only.
-    # @param speaker_labels [Boolean] Indicates whether labels that identify which words were spoken by which participants in a multi-person exchange are to be included in the response. The default is `false`; no speaker labels are returned. Setting `speaker_labels` to `true` forces the `timestamps` parameter to be `true`, regardless of whether you specify `false` for the parameter.   To determine whether a language model supports speaker labels, use the `GET /v1/models` method and check that the attribute `speaker_labels` is set to `true`. You can also refer to [Speaker labels](https://console.bluemix.net/docs/services/speech-to-text/output.html#speaker_labels).
+    # @param speaker_labels [Boolean] Indicates whether labels that identify which words were spoken by which participants in a multi-person exchange are to be included in the response. The default is `false`; no speaker labels are returned. Setting `speaker_labels` to `true` forces the `timestamps` parameter to be `true`, regardless of whether you specify `false` for the parameter.   To determine whether a language model supports speaker labels, use the `GET /v1/models` method and check that the attribute `speaker_labels` is set to `true`. You can also refer to [Speaker labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#speaker_labels).
     # @param grammar_name [String] The name of a grammar that is to be used with the recognition request. If you
     #   specify a grammar, you must also use the `language_customization_id` parameter to
     #   specify the name of the custom language model for which the grammar is defined.
     #   The service recognizes only strings that are recognized by the specified grammar;
     #   it does not recognize other custom words from the model's words resource. See
-    #   [Grammars](https://cloud.ibm.com/docs/services/speech-to-text/output.html).
+    #   [Grammars](https://cloud.ibm.com/docs/speech-to-text/output.html).
     # @param redaction [Boolean] If `true`, the service redacts, or masks, numeric data from final transcripts. The
     #   feature redacts any number that has three or more consecutive digits by replacing
     #   each digit with an `X` character. It is intended to redact sensitive numeric data,
@@ -520,7 +521,7 @@ module IBMWatson
     #   **Note:** Applies to US English, Japanese, and Korean transcription only.
     #
     #   See [Numeric
-    #   redaction](https://cloud.ibm.com/docs/services/speech-to-text/output.html#redaction).
+    #   redaction](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#redaction).
     #
     # @param processing_metrics [Boolean] If `true`, requests processing metrics about the service's transcription of the
     #   input audio. The service returns processing metrics at the interval specified by
@@ -542,7 +543,7 @@ module IBMWatson
     # @return [WebSocketClient] Returns a new WebSocketClient object
     #
     #   See [Audio
-    #   metrics](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-metrics#audio_metrics).
+    #   metrics](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-metrics#audio_metrics).
     # @param end_of_phrase_silence_time [Float] If `true`, specifies the duration of the pause interval at which the service
     #   splits a transcript into multiple final results. If the service detects pauses or
     #   extended silence before it reaches the end of the audio stream, its response can
@@ -559,7 +560,7 @@ module IBMWatson
     #   Chinese is 0.6 seconds.
     #
     #   See [End of phrase silence
-    #   time](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#silence_time).
+    #   time](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#silence_time).
     # @param split_transcript_at_phrase_end [Boolean] If `true`, directs the service to split the transcript into multiple final results
     #   based on semantic features of the input, for example, at the conclusion of
     #   meaningful phrases such as sentences. The service bases its understanding of
@@ -569,7 +570,7 @@ module IBMWatson
     #   interval.
     #
     #   See [Split transcript at phrase
-    #   end](https://cloud.ibm.com/docs/services/speech-to-text?topic=speech-to-text-output#split_transcript).
+    #   end](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#split_transcript).
     # @param speech_detector_sensitivity [Float] The sensitivity of speech activity detection that the service is to perform. Use
     #   the parameter to suppress word insertions from music, coughing, and other
     #   non-speech events. The service biases the audio it passes for speech recognition
@@ -681,9 +682,9 @@ module IBMWatson
     # @!method register_callback(callback_url:, user_secret: nil)
     # Register a callback.
     # Registers a callback URL with the service for use with subsequent asynchronous
-    #   recognition requests. The service attempts to register, or white-list, the
-    #   callback URL if it is not already registered by sending a `GET` request to the
-    #   callback URL. The service passes a random alphanumeric challenge string via the
+    #   recognition requests. The service attempts to register, or allowlist, the callback
+    #   URL if it is not already registered by sending a `GET` request to the callback
+    #   URL. The service passes a random alphanumeric challenge string via the
     #   `challenge_string` parameter of the request. The request includes an `Accept`
     #   header that specifies `text/plain` as the required response type.
     #
@@ -695,9 +696,9 @@ module IBMWatson
     #
     #   The service sends only a single `GET` request to the callback URL. If the service
     #   does not receive a reply with a response code of 200 and a body that echoes the
-    #   challenge string sent by the service within five seconds, it does not white-list
+    #   challenge string sent by the service within five seconds, it does not allowlist
     #   the URL; it instead sends status code 400 in response to the **Register a
-    #   callback** request. If the requested callback URL is already white-listed, the
+    #   callback** request. If the requested callback URL is already allowlisted, the
     #   service responds to the initial registration request with response code 200.
     #
     #   If you specify a user secret with the request, the service uses it as a key to
@@ -715,7 +716,7 @@ module IBMWatson
     #   **See also:** [Registering a callback
     #   URL](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-async#register).
     # @param callback_url [String] An HTTP or HTTPS URL to which callback notifications are to be sent. To be
-    #   white-listed, the URL must successfully echo the challenge string during URL
+    #   allowlisted, the URL must successfully echo the challenge string during URL
     #   verification. During verification, the client can also check the signature that
     #   the service sends in the `X-Callback-Signature` header to verify the origin of the
     #   request.
@@ -753,7 +754,7 @@ module IBMWatson
     ##
     # @!method unregister_callback(callback_url:)
     # Unregister a callback.
-    # Unregisters a callback URL that was previously white-listed with a **Register a
+    # Unregisters a callback URL that was previously allowlisted with a **Register a
     #   callback** request for use with the asynchronous interface. Once unregistered, the
     #   URL can no longer be used with asynchronous recognition requests.
     #
@@ -884,14 +885,14 @@ module IBMWatson
     #
     #    **See also:** [Audio
     #   formats](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-audio-formats#audio-formats).
-    # @param audio [String] The audio to transcribe.
+    # @param audio [File] The audio to transcribe.
     # @param content_type [String] The format (MIME type) of the audio. For more information about specifying an
     #   audio format, see **Audio formats (content types)** in the method description.
     # @param model [String] The identifier of the model that is to be used for the recognition request. See
     #   [Languages and
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models#models).
     # @param callback_url [String] A URL to which callback notifications are to be sent. The URL must already be
-    #   successfully white-listed by using the **Register a callback** method. You can
+    #   successfully allowlisted by using the **Register a callback** method. You can
     #   include the same callback URL with any number of job creation requests. Omit the
     #   parameter to poll the service for job completion and results.
     #
@@ -1024,11 +1025,9 @@ module IBMWatson
     #   parameter to be `true`, regardless of whether you specify `false` for the
     #   parameter.
     #
-    #   **Note:** Applies to US English, German, Japanese, Korean, and Spanish (both
-    #   broadband and narrowband models) and UK English (narrowband model) transcription
-    #   only. To determine whether a language model supports speaker labels, you can also
-    #   use the **Get a model** method and check that the attribute `speaker_labels` is
-    #   set to `true`.
+    #   **Note:** Applies to US English, Australian English, German, Japanese, Korean, and
+    #   Spanish (both broadband and narrowband models) and UK English (narrowband model)
+    #   transcription only.
     #
     #   See [Speaker
     #   labels](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-output#speaker_labels).
@@ -1393,8 +1392,12 @@ module IBMWatson
     #   **See also:** [Listing custom language
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language).
     # @param language [String] The identifier of the language for which custom language or custom acoustic models
-    #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
-    #   language or custom acoustic models that are owned by the requesting credentials.
+    #   are to be returned. Omit the parameter to see all custom language or custom
+    #   acoustic models that are owned by the requesting credentials.
+    #
+    #   To determine the languages for which customization is available, see [Language
+    #   support for
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_language_models(language: nil)
       headers = {
@@ -2513,8 +2516,12 @@ module IBMWatson
     #   **See also:** [Listing custom acoustic
     #   models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageAcousticModels#listModels-acoustic).
     # @param language [String] The identifier of the language for which custom language or custom acoustic models
-    #   are to be returned (for example, `en-US`). Omit the parameter to see all custom
-    #   language or custom acoustic models that are owned by the requesting credentials.
+    #   are to be returned. Omit the parameter to see all custom language or custom
+    #   acoustic models that are owned by the requesting credentials.
+    #
+    #   To determine the languages for which customization is available, see [Language
+    #   support for
+    #   customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-customization#languageSupport).
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def list_acoustic_models(language: nil)
       headers = {
@@ -2612,14 +2619,14 @@ module IBMWatson
     #   it. You must use credentials for the instance of the service that owns a model to
     #   train it.
     #
-    #   The training method is asynchronous. It can take on the order of minutes or hours
-    #   to complete depending on the total amount of audio data on which the custom
-    #   acoustic model is being trained and the current load on the service. Typically,
-    #   training a custom acoustic model takes approximately two to four times the length
-    #   of its audio data. The actual time depends on the model being trained and the
-    #   nature of the audio, such as whether the audio is clean or noisy. The method
-    #   returns an HTTP 200 response code to indicate that the training process has begun.
-    #
+    #   The training method is asynchronous. Training time depends on the cumulative
+    #   amount of audio data that the custom acoustic model contains and the current load
+    #   on the service. When you train or retrain a model, the service uses all of the
+    #   model's audio data in the training. Training a custom acoustic model takes
+    #   approximately as long as the length of its cumulative audio data. For example, it
+    #   takes approximately 2 hours to train a model that contains a total of 2 hours of
+    #   audio. The method returns an HTTP 200 response code to indicate that the training
+    #   process has begun.
     #
     #   You can monitor the status of the training by using the **Get a custom acoustic
     #   model** method to poll the model's status. Use a loop to check the status once a
@@ -2963,7 +2970,7 @@ module IBMWatson
     #   used, their use is strongly discouraged.)
     #   * Do not use the name of an audio resource that has already been added to the
     #   custom model.
-    # @param audio_resource [String] The audio resource that is to be added to the custom acoustic model, an individual
+    # @param audio_resource [File] 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
@@ -3131,10 +3138,15 @@ module IBMWatson
     #   deletes all data for the customer ID, regardless of the method by which the
     #   information was added. The method has no effect if no data is associated with the
     #   customer ID. You must issue the request with credentials for the same instance of
-    #   the service that was used to associate the customer ID with the data.
-    #
-    #   You associate a customer ID with data by passing the `X-Watson-Metadata` header
-    #   with a request that passes the data.
+    #   the service that was used to associate the customer ID with the data. You
+    #   associate a customer ID with data by passing the `X-Watson-Metadata` header with a
+    #   request that passes the data.
+    #
+    #   **Note:** If you delete an instance of the service from the service console, all
+    #   data associated with that service instance is automatically deleted. This includes
+    #   all custom language models, corpora, grammars, and words; all custom acoustic
+    #   models and audio resources; all registered endpoints for the asynchronous HTTP
+    #   interface; and all data related to speech recognition requests.
     #
     #   **See also:** [Information
     #   security](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-information-security#information-security).

data/lib/ibm_watson/text_to_speech_v1.rb

@@ -13,25 +13,28 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-
-# The IBM® Text to Speech service provides APIs that use IBM's speech-synthesis
-# capabilities to synthesize text into natural-sounding speech in a variety of languages,
-# dialects, and voices. The service supports at least one male or female voice, sometimes
-# both, for each language. The audio is streamed back to the client with minimal delay.
+#
+# IBM OpenAPI SDK Code Generator Version: 3.19.0-be3b4618-20201113-200858
+#
+# The IBM Watson™ Text to Speech service provides APIs that use IBM's
+# speech-synthesis capabilities to synthesize text into natural-sounding speech in a
+# variety of languages, dialects, and voices. The service supports at least one male or
+# female voice, sometimes both, for each language. The audio is streamed back to the
+# client with minimal delay.
 #
 # For speech synthesis, the service supports a synchronous HTTP Representational State
-# Transfer (REST) interface. It also supports a WebSocket interface that provides both
-# plain text and SSML input, including the SSML <mark> element and word timings.
-# SSML is an XML-based markup language that provides text annotation for speech-synthesis
-# applications.
+# Transfer (REST) interface and a WebSocket interface. Both interfaces support plain text
+# and SSML input. SSML is an XML-based markup language that provides text annotation for
+# speech-synthesis applications. The WebSocket interface also supports the SSML
+# <code>&lt;mark&gt;</code> element and word timings.
 #
-# The service also offers a customization interface. You can use the interface to define
-# sounds-like or phonetic translations for words. A sounds-like translation consists of
-# one or more words that, when combined, sound like the word. A phonetic translation is
-# based on the SSML phoneme format for representing a word. You can specify a phonetic
-# translation in standard International Phonetic Alphabet (IPA) representation or in the
-# proprietary IBM Symbolic Phonetic Representation (SPR). The Arabic, Chinese, Dutch, and
-# Korean languages support only IPA.
+# The service offers a customization interface that you can use to define sounds-like or
+# phonetic translations for words. A sounds-like translation consists of one or more words
+# that, when combined, sound like the word. A phonetic translation is based on the SSML
+# phoneme format for representing a word. You can specify a phonetic translation in
+# standard International Phonetic Alphabet (IPA) representation or in the proprietary IBM
+# Symbolic Phonetic Representation (SPR). The Arabic, Chinese, Dutch, and Korean languages
+# support only IPA.
 
 require "concurrent"
 require "erb"
@@ -46,7 +49,7 @@ module IBMWatson
   class TextToSpeechV1 < IBMCloudSdkCore::BaseService
     include Concurrent::Async
     DEFAULT_SERVICE_NAME = "text_to_speech"
-    DEFAULT_SERVICE_URL = "https://stream.watsonplatform.net/text-to-speech/api"
+    DEFAULT_SERVICE_URL = "https://api.us-south.text-to-speech.watson.cloud.ibm.com"
     ##
     # @!method initialize(args)
     # Construct a new client for the Text to Speech service.
@@ -78,8 +81,10 @@ module IBMWatson
     # @!method list_voices
     # List voices.
     # Lists all voices available for use with the service. The information includes the
-    #   name, language, gender, and other details about the voice. To see information
-    #   about a specific voice, use the **Get a voice** method.
+    #   name, language, gender, and other details about the voice. The ordering of the
+    #   list of voices can change from call to call; do not rely on an alphabetized or
+    #   static list of voices. To see information about a specific voice, use the **Get a
+    #   voice** method.
     #
     #   **See also:** [Listing all available
     #   voices](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-voices#listVoices).
@@ -106,14 +111,14 @@ module IBMWatson
     # Get a voice.
     # Gets information about the specified voice. The information includes the name,
     #   language, gender, and other details about the voice. Specify a customization ID to
-    #   obtain information for a custom voice model that is defined for the language of
-    #   the specified voice. To list information about all available voices, use the
-    #   **List voices** method.
+    #   obtain information for a custom model that is defined for the language of the
+    #   specified voice. To list information about all available voices, use the **List
+    #   voices** method.
     #
     #   **See also:** [Listing a specific
     #   voice](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-voices#listVoice).
     # @param voice [String] The voice for which information is to be returned.
-    # @param customization_id [String] The customization ID (GUID) of a custom voice model for which information is to be
+    # @param customization_id [String] The customization ID (GUID) of a custom model for which information is to be
     #   returned. You must make the request with credentials for the instance of the
     #   service that owns the custom model. Omit the parameter to see information about
     #   the specified voice with no customization.
@@ -222,8 +227,8 @@ module IBMWatson
     #   specifying an audio format, see **Audio formats (accept types)** in the method
     #   description.
     # @param voice [String] The voice to use for synthesis.
-    # @param customization_id [String] The customization ID (GUID) of a custom voice model to use for the synthesis. If a
-    #   custom voice model is specified, it works only if it matches the language of the
+    # @param customization_id [String] The customization ID (GUID) of a custom model to use for the synthesis. If a
+    #   custom model is specified, it works only if it matches the language of the
     #   indicated voice. You must make the request with credentials for the instance of
     #   the service that owns the custom model. Omit the parameter to use the specified
     #   voice with no customization.
@@ -268,9 +273,7 @@ module IBMWatson
     # Gets the phonetic pronunciation for the specified word. You can request the
     #   pronunciation for a specific format. You can also request the pronunciation for a
     #   specific voice to see the default translation for the language of that voice or
-    #   for a specific custom voice model to see the translation for that voice model.
-    #
-    #   **Note:** This method is currently a beta release.
+    #   for a specific custom model to see the translation for that model.
     #
     #   **See also:** [Querying a word from a
     #   language](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuWordsQueryLanguage).
@@ -281,13 +284,13 @@ module IBMWatson
     # @param format [String] The phoneme format in which to return the pronunciation. The Arabic, Chinese,
     #   Dutch, and Korean languages support only IPA. Omit the parameter to obtain the
     #   pronunciation in the default format.
-    # @param customization_id [String] The customization ID (GUID) of a custom voice model for which the pronunciation is
-    #   to be returned. The language of a specified custom model must match the language
-    #   of the specified voice. If the word is not defined in the specified custom model,
-    #   the service returns the default translation for the custom model's language. You
-    #   must make the request with credentials for the instance of the service that owns
-    #   the custom model. Omit the parameter to see the translation for the specified
-    #   voice with no customization.
+    # @param customization_id [String] The customization ID (GUID) of a custom model for which the pronunciation is to be
+    #   returned. The language of a specified custom model must match the language of the
+    #   specified voice. If the word is not defined in the specified custom model, the
+    #   service returns the default translation for the custom model's language. You must
+    #   make the request with credentials for the instance of the service that owns the
+    #   custom model. Omit the parameter to see the translation for the specified voice
+    #   with no customization.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_pronunciation(text:, voice: nil, format: nil, customization_id: nil)
       raise ArgumentError.new("text must be provided") if text.nil?
@@ -320,31 +323,28 @@ module IBMWatson
     #########################
 
     ##
-    # @!method create_voice_model(name:, language: nil, description: nil)
+    # @!method create_custom_model(name:, language: nil, description: nil)
     # Create a custom model.
-    # Creates a new empty custom voice model. You must specify a name for the new custom
+    # Creates a new empty custom model. You must specify a name for the new custom
     #   model. You can optionally specify the language and a description for the new
     #   model. The model is owned by the instance of the service whose credentials are
     #   used to create it.
     #
-    #   **Note:** This method is currently a beta release.
-    #
     #   **See also:** [Creating a custom
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customModels#cuModelsCreate).
-    # @param name [String] The name of the new custom voice model.
-    # @param language [String] The language of the new custom voice model. You create a custom voice model for a
-    #   specific language, not for a specific voice. A custom model can be used with any
-    #   voice, standard or neural, for its specified language. Omit the parameter to use
-    #   the the default language, `en-US`.
-    # @param description [String] A description of the new custom voice model. Specifying a description is
-    #   recommended.
+    # @param name [String] The name of the new custom model.
+    # @param language [String] The language of the new custom model. You create a custom model for a specific
+    #   language, not for a specific voice. A custom model can be used with any voice,
+    #   standard or neural, for its specified language. Omit the parameter to use the the
+    #   default language, `en-US`.
+    # @param description [String] A description of the new custom model. Specifying a description is recommended.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def create_voice_model(name:, language: nil, description: nil)
+    def create_custom_model(name:, language: nil, description: nil)
       raise ArgumentError.new("name must be provided") if name.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("text_to_speech", "V1", "create_voice_model")
+      sdk_headers = Common.new.get_sdk_headers("text_to_speech", "V1", "create_custom_model")
       headers.merge!(sdk_headers)
 
       data = {
@@ -366,27 +366,25 @@ module IBMWatson
     end
 
     ##
-    # @!method list_voice_models(language: nil)
+    # @!method list_custom_models(language: nil)
     # List custom models.
-    # Lists metadata such as the name and description for all custom voice models that
-    #   are owned by an instance of the service. Specify a language to list the voice
-    #   models for that language only. To see the words in addition to the metadata for a
-    #   specific voice model, use the **List a custom model** method. You must use
+    # Lists metadata such as the name and description for all custom models that are
+    #   owned by an instance of the service. Specify a language to list the custom models
+    #   for that language only. To see the words in addition to the metadata for a
+    #   specific custom model, use the **List a custom model** method. You must use
     #   credentials for the instance of the service that owns a model to list information
     #   about it.
     #
-    #   **Note:** This method is currently a beta release.
-    #
     #   **See also:** [Querying all custom
     #   models](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customModels#cuModelsQueryAll).
-    # @param language [String] The language for which custom voice models that are owned by the requesting
-    #   credentials are to be returned. Omit the parameter to see all custom voice models
-    #   that are owned by the requester.
+    # @param language [String] The language for which custom models that are owned by the requesting credentials
+    #   are to be returned. Omit the parameter to see all custom models that are owned by
+    #   the requester.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
-    def list_voice_models(language: nil)
+    def list_custom_models(language: nil)
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("text_to_speech", "V1", "list_voice_models")
+      sdk_headers = Common.new.get_sdk_headers("text_to_speech", "V1", "list_custom_models")
       headers.merge!(sdk_headers)
 
       params = {
@@ -406,14 +404,14 @@ module IBMWatson
     end
 
     ##
-    # @!method update_voice_model(customization_id:, name: nil, description: nil, words: nil)
+    # @!method update_custom_model(customization_id:, name: nil, description: nil, words: nil)
     # Update a custom model.
-    # Updates information for the specified custom voice model. You can update metadata
-    #   such as the name and description of the voice model. You can also update the words
-    #   in the model and their translations. Adding a new translation for a word that
-    #   already exists in a custom model overwrites the word's existing translation. A
-    #   custom model can contain no more than 20,000 entries. You must use credentials for
-    #   the instance of the service that owns a model to update it.
+    # Updates information for the specified custom model. You can update metadata such
+    #   as the name and description of the model. You can also update the words in the
+    #   model and their translations. Adding a new translation for a word that already
+    #   exists in a custom model overwrites the word's existing translation. A custom
+    #   model can contain no more than 20,000 entries. You must use credentials for the
+    #   instance of the service that owns a model to update it.
     #
     #   You can define sounds-like or phonetic translations for words. A sounds-like
     #   translation consists of one or more words that, when combined, sound like the
@@ -429,8 +427,6 @@ module IBMWatson
     #     <code>&lt;phoneme alphabet="ibm"
     #   ph="1gAstroEntxrYFXs"&gt;&lt;/phoneme&gt;</code>
     #
-    #   **Note:** This method is currently a beta release.
-    #
     #   **See also:**
     #   * [Updating a custom
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customModels#cuModelsUpdate)
@@ -438,20 +434,20 @@ module IBMWatson
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuJapaneseAdd)
     #   * [Understanding
     #   customization](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customIntro#customIntro).
-    # @param customization_id [String] The customization ID (GUID) of the custom voice model. You must make the request
-    #   with credentials for the instance of the service that owns the custom model.
-    # @param name [String] A new name for the custom voice model.
-    # @param description [String] A new description for the custom voice model.
+    # @param customization_id [String] The customization ID (GUID) of the custom model. You must make the request with
+    #   credentials for the instance of the service that owns the custom model.
+    # @param name [String] A new name for the custom model.
+    # @param description [String] A new description for the custom model.
     # @param words [Array[Word]] An array of `Word` objects that provides the words and their translations that are
-    #   to be added or updated for the custom voice model. Pass an empty array to make no
+    #   to be added or updated for the custom model. Pass an empty array to make no
     #   additions or updates.
     # @return [nil]
-    def update_voice_model(customization_id:, name: nil, description: nil, words: nil)
+    def update_custom_model(customization_id:, name: nil, description: nil, words: nil)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("text_to_speech", "V1", "update_voice_model")
+      sdk_headers = Common.new.get_sdk_headers("text_to_speech", "V1", "update_custom_model")
       headers.merge!(sdk_headers)
 
       data = {
@@ -473,26 +469,24 @@ module IBMWatson
     end
 
     ##
-    # @!method get_voice_model(customization_id:)
+    # @!method get_custom_model(customization_id:)
     # Get a custom model.
-    # Gets all information about a specified custom voice model. In addition to metadata
-    #   such as the name and description of the voice model, the output includes the words
-    #   and their translations as defined in the model. To see just the metadata for a
-    #   voice model, use the **List custom models** method.
-    #
-    #   **Note:** This method is currently a beta release.
+    # Gets all information about a specified custom model. In addition to metadata such
+    #   as the name and description of the custom model, the output includes the words and
+    #   their translations as defined in the model. To see just the metadata for a model,
+    #   use the **List custom models** method.
     #
     #   **See also:** [Querying a custom
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customModels#cuModelsQuery).
-    # @param customization_id [String] The customization ID (GUID) of the custom voice model. You must make the request
-    #   with credentials for the instance of the service that owns the custom model.
+    # @param customization_id [String] The customization ID (GUID) of the custom model. 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 get_voice_model(customization_id:)
+    def get_custom_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("text_to_speech", "V1", "get_voice_model")
+      sdk_headers = Common.new.get_sdk_headers("text_to_speech", "V1", "get_custom_model")
       headers.merge!(sdk_headers)
 
       method_url = "/v1/customizations/%s" % [ERB::Util.url_encode(customization_id)]
@@ -507,24 +501,22 @@ module IBMWatson
     end
 
     ##
-    # @!method delete_voice_model(customization_id:)
+    # @!method delete_custom_model(customization_id:)
     # Delete a custom model.
-    # Deletes the specified custom voice model. You must use credentials for the
-    #   instance of the service that owns a model to delete it.
-    #
-    #   **Note:** This method is currently a beta release.
+    # Deletes the specified custom model. You must use credentials for the instance of
+    #   the service that owns a model to delete it.
     #
     #   **See also:** [Deleting a custom
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customModels#cuModelsDelete).
-    # @param customization_id [String] The customization ID (GUID) of the custom voice model. You must make the request
-    #   with credentials for the instance of the service that owns the custom model.
+    # @param customization_id [String] The customization ID (GUID) of the custom model. You must make the request with
+    #   credentials for the instance of the service that owns the custom model.
     # @return [nil]
-    def delete_voice_model(customization_id:)
+    def delete_custom_model(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
 
       headers = {
       }
-      sdk_headers = Common.new.get_sdk_headers("text_to_speech", "V1", "delete_voice_model")
+      sdk_headers = Common.new.get_sdk_headers("text_to_speech", "V1", "delete_custom_model")
       headers.merge!(sdk_headers)
 
       method_url = "/v1/customizations/%s" % [ERB::Util.url_encode(customization_id)]
@@ -544,7 +536,7 @@ module IBMWatson
     ##
     # @!method add_words(customization_id:, words:)
     # Add custom words.
-    # Adds one or more words and their translations to the specified custom voice model.
+    # Adds one or more words and their translations to the specified custom model.
     #   Adding a new translation for a word that already exists in a custom model
     #   overwrites the word's existing translation. A custom model can contain no more
     #   than 20,000 entries. You must use credentials for the instance of the service that
@@ -564,8 +556,6 @@ module IBMWatson
     #     <code>&lt;phoneme alphabet="ibm"
     #   ph="1gAstroEntxrYFXs"&gt;&lt;/phoneme&gt;</code>
     #
-    #   **Note:** This method is currently a beta release.
-    #
     #   **See also:**
     #   * [Adding multiple words to a custom
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuWordsAdd)
@@ -573,15 +563,15 @@ module IBMWatson
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuJapaneseAdd)
     #   * [Understanding
     #   customization](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customIntro#customIntro).
-    # @param customization_id [String] The customization ID (GUID) of the custom voice model. You must make the request
-    #   with credentials for the instance of the service that owns the custom model.
+    # @param customization_id [String] The customization ID (GUID) of the custom model. You must make the request with
+    #   credentials for the instance of the service that owns the custom model.
     # @param words [Array[Word]] The **Add custom words** method accepts an array of `Word` objects. Each object
-    #   provides a word that is to be added or updated for the custom voice model and the
-    #   word's translation.
+    #   provides a word that is to be added or updated for the custom model and the word's
+    #   translation.
     #
     #   The **List custom words** method returns an array of `Word` objects. Each object
-    #   shows a word and its translation from the custom voice model. The words are listed
-    #   in alphabetical order, with uppercase letters listed before lowercase letters. The
+    #   shows a word and its translation from the custom model. The words are listed in
+    #   alphabetical order, with uppercase letters listed before lowercase letters. The
     #   array is empty if the custom model contains no words.
     # @return [nil]
     def add_words(customization_id:, words:)
@@ -613,17 +603,14 @@ module IBMWatson
     ##
     # @!method list_words(customization_id:)
     # List custom words.
-    # Lists all of the words and their translations for the specified custom voice
-    #   model. The output shows the translations as they are defined in the model. You
-    #   must use credentials for the instance of the service that owns a model to list its
-    #   words.
-    #
-    #   **Note:** This method is currently a beta release.
+    # Lists all of the words and their translations for the specified custom model. The
+    #   output shows the translations as they are defined in the model. You must use
+    #   credentials for the instance of the service that owns a model to list its words.
     #
     #   **See also:** [Querying all words from a custom
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuWordsQueryModel).
-    # @param customization_id [String] The customization ID (GUID) of the custom voice model. You must make the request
-    #   with credentials for the instance of the service that owns the custom model.
+    # @param customization_id [String] The customization ID (GUID) of the custom model. 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_words(customization_id:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -647,11 +634,11 @@ module IBMWatson
     ##
     # @!method add_word(customization_id:, word:, translation:, part_of_speech: nil)
     # Add a custom word.
-    # Adds a single word and its translation to the specified custom voice model. Adding
-    #   a new translation for a word that already exists in a custom model overwrites the
-    #   word's existing translation. A custom model can contain no more than 20,000
-    #   entries. You must use credentials for the instance of the service that owns a
-    #   model to add a word to it.
+    # Adds a single word and its translation to the specified custom model. Adding a new
+    #   translation for a word that already exists in a custom model overwrites the word's
+    #   existing translation. A custom model can contain no more than 20,000 entries. You
+    #   must use credentials for the instance of the service that owns a model to add a
+    #   word to it.
     #
     #   You can define sounds-like or phonetic translations for words. A sounds-like
     #   translation consists of one or more words that, when combined, sound like the
@@ -667,8 +654,6 @@ module IBMWatson
     #     <code>&lt;phoneme alphabet="ibm"
     #   ph="1gAstroEntxrYFXs"&gt;&lt;/phoneme&gt;</code>
     #
-    #   **Note:** This method is currently a beta release.
-    #
     #   **See also:**
     #   * [Adding a single word to a custom
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuWordAdd)
@@ -676,9 +661,9 @@ module IBMWatson
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuJapaneseAdd)
     #   * [Understanding
     #   customization](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customIntro#customIntro).
-    # @param customization_id [String] The customization ID (GUID) of the custom voice model. You must make the request
-    #   with credentials for the instance of the service that owns the custom model.
-    # @param word [String] The word that is to be added or updated for the custom voice model.
+    # @param customization_id [String] The customization ID (GUID) of the custom model. You must make the request with
+    #   credentials for the instance of the service that owns the custom model.
+    # @param word [String] The word that is to be added or updated for the custom model.
     # @param translation [String] The phonetic or sounds-like translation for the word. A phonetic translation is
     #   based on the SSML format for representing the phonetic string of a word either as
     #   an IPA translation or as an IBM SPR translation. The Arabic, Chinese, Dutch, and
@@ -727,13 +712,11 @@ module IBMWatson
     #   shows the translation as it is defined in the model. You must use credentials for
     #   the instance of the service that owns a model to list its words.
     #
-    #   **Note:** This method is currently a beta release.
-    #
     #   **See also:** [Querying a single word from a custom
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuWordQueryModel).
-    # @param customization_id [String] The customization ID (GUID) of the custom voice model. You must make the request
-    #   with credentials for the instance of the service that owns the custom model.
-    # @param word [String] The word that is to be queried from the custom voice model.
+    # @param customization_id [String] The customization ID (GUID) of the custom model. You must make the request with
+    #   credentials for the instance of the service that owns the custom model.
+    # @param word [String] The word that is to be queried from the custom model.
     # @return [IBMCloudSdkCore::DetailedResponse] A `IBMCloudSdkCore::DetailedResponse` object representing the response.
     def get_word(customization_id:, word:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -759,17 +742,14 @@ module IBMWatson
     ##
     # @!method delete_word(customization_id:, word:)
     # Delete a custom word.
-    # Deletes a single word from the specified custom voice model. You must use
-    #   credentials for the instance of the service that owns a model to delete its words.
-    #
-    #
-    #   **Note:** This method is currently a beta release.
+    # Deletes a single word from the specified custom model. You must use credentials
+    #   for the instance of the service that owns a model to delete its words.
     #
     #   **See also:** [Deleting a word from a custom
     #   model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuWordDelete).
-    # @param customization_id [String] The customization ID (GUID) of the custom voice model. You must make the request
-    #   with credentials for the instance of the service that owns the custom model.
-    # @param word [String] The word that is to be deleted from the custom voice model.
+    # @param customization_id [String] The customization ID (GUID) of the custom model. You must make the request with
+    #   credentials for the instance of the service that owns the custom model.
+    # @param word [String] The word that is to be deleted from the custom model.
     # @return [nil]
     def delete_word(customization_id:, word:)
       raise ArgumentError.new("customization_id must be provided") if customization_id.nil?
@@ -802,10 +782,14 @@ module IBMWatson
     #   deletes all data for the customer ID, regardless of the method by which the
     #   information was added. The method has no effect if no data is associated with the
     #   customer ID. You must issue the request with credentials for the same instance of
-    #   the service that was used to associate the customer ID with the data.
-    #
-    #   You associate a customer ID with data by passing the `X-Watson-Metadata` header
-    #   with a request that passes the data.
+    #   the service that was used to associate the customer ID with the data. You
+    #   associate a customer ID with data by passing the `X-Watson-Metadata` header with a
+    #   request that passes the data.
+    #
+    #   **Note:** If you delete an instance of the service from the service console, all
+    #   data associated with that service instance is automatically deleted. This includes
+    #   all custom models and word/translation pairs, and all data related to speech
+    #   synthesis requests.
     #
     #   **See also:** [Information
     #   security](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-information-security#information-security).