feat(speech-to-text-v1): add de-de_multimedia & update comments

Author: kevinkowa

src/IBM.Watson.SpeechToText.v1/Model/SpeechRecognitionAlternative.cs

@@ -1,5 +1,5 @@
 /**
-* (C) Copyright IBM Corp. 2017, 2021.
+* (C) Copyright IBM Corp. 2022.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -46,7 +46,7 @@ public class SpeechRecognitionAlternative
         /// <summary>
         /// A confidence score for each word of the transcript as a list of lists. Each inner list consists of two
         /// elements: the word and its confidence score in the range of 0.0 to 1.0, for example:
-        /// `[["hello",0.95],["world",0.866]]`. Confidence scores are returned only for the best alternative and only
+        /// `[["hello",0.95],["world",0.86]]`. Confidence scores are returned only for the best alternative and only
         /// with results marked as final.
         /// </summary>
         [JsonProperty("word_confidence", NullValueHandling = NullValueHandling.Ignore)]

src/IBM.Watson.SpeechToText.v1/SpeechToTextService.cs

@@ -179,6 +179,10 @@ public class ModelIdValue
                 /// </summary>
                 public const string DE_DE_BROADBANDMODEL = "de-DE_BroadbandModel";
                 /// <summary>
+                /// Constant DE_DE_MULTIMEDIA for de-DE_Multimedia
+                /// </summary>
+                public const string DE_DE_MULTIMEDIA = "de-DE_Multimedia";
+                /// <summary>
                 /// Constant DE_DE_NARROWBANDMODEL for de-DE_NarrowbandModel
                 /// </summary>
                 public const string DE_DE_NARROWBANDMODEL = "de-DE_NarrowbandModel";
@@ -496,8 +500,8 @@ public class ModelIdValue
         /// **Important:** Effective 15 March 2022, previous-generation models for all languages other than Arabic and
         /// Japanese are deprecated. The deprecated models remain available until 15 September 2022, when they will be
         /// removed from the service and the documentation. You must migrate to the equivalent next-generation model by
-        /// the end of service date. For more information, see [Previous-generation languages and
-        /// models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models).
+        /// the end of service date. For more information, see [Migrating to next-generation
+        /// models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-migrate).
         ///
         /// **See also:**
         /// * [Next-generation languages and
@@ -994,6 +998,10 @@ public class ModelValue
                 /// </summary>
                 public const string DE_DE_BROADBANDMODEL = "de-DE_BroadbandModel";
                 /// <summary>
+                /// Constant DE_DE_MULTIMEDIA for de-DE_Multimedia
+                /// </summary>
+                public const string DE_DE_MULTIMEDIA = "de-DE_Multimedia";
+                /// <summary>
                 /// Constant DE_DE_NARROWBANDMODEL for de-DE_NarrowbandModel
                 /// </summary>
                 public const string DE_DE_NARROWBANDMODEL = "de-DE_NarrowbandModel";
@@ -1470,8 +1478,8 @@ public DetailedResponse<object> UnregisterCallback(string callbackUrl)
         /// **Important:** Effective 15 March 2022, previous-generation models for all languages other than Arabic and
         /// Japanese are deprecated. The deprecated models remain available until 15 September 2022, when they will be
         /// removed from the service and the documentation. You must migrate to the equivalent next-generation model by
-        /// the end of service date. For more information, see [Previous-generation languages and
-        /// models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models).
+        /// the end of service date. For more information, see  [Migrating to next-generation
+        /// models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-migrate).
         ///
         /// **See also:**
         /// * [Next-generation languages and
@@ -2029,6 +2037,10 @@ public class ModelValue
                 /// </summary>
                 public const string DE_DE_BROADBANDMODEL = "de-DE_BroadbandModel";
                 /// <summary>
+                /// Constant DE_DE_MULTIMEDIA for de-DE_Multimedia
+                /// </summary>
+                public const string DE_DE_MULTIMEDIA = "de-DE_Multimedia";
+                /// <summary>
                 /// Constant DE_DE_NARROWBANDMODEL for de-DE_NarrowbandModel
                 /// </summary>
                 public const string DE_DE_NARROWBANDMODEL = "de-DE_NarrowbandModel";
@@ -2478,11 +2490,14 @@ public DetailedResponse<object> DeleteJob(string id)
         /// **Important:** Effective 15 March 2022, previous-generation models for all languages other than Arabic and
         /// Japanese are deprecated. The deprecated models remain available until 15 September 2022, when they will be
         /// removed from the service and the documentation. You must migrate to the equivalent next-generation model by
-        /// the end of service date. For more information, see [Previous-generation languages and
-        /// models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models).
+        /// the end of service date. For more information, see [Migrating to next-generation
+        /// models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-migrate).
         ///
-        /// **See also:** [Create a custom language
-        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#createModel-language).
+        /// **See also:**
+        /// * [Create a custom language
+        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#createModel-language)
+        /// * [Language support for
+        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
         /// </summary>
         /// <param name="name">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.
@@ -2580,8 +2595,11 @@ public DetailedResponse<LanguageModel> CreateLanguageModel(string name, string b
         /// 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/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language).
+        /// **See also:**
+        /// * [Listing custom language
+        /// models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language)
+        /// * [Language support for
+        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
         /// </summary>
         /// <param name="language">The identifier of the language for which custom language or custom acoustic models
         /// are to be returned. Specify the five-character language identifier; for example, specify `en-US` to see all
@@ -2759,8 +2777,11 @@ public class LanguageValue
         /// Gets information about a specified custom language model. 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/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language).
+        /// **See also:**
+        /// * [Listing custom language
+        /// models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#listModels-language)
+        /// * [Language support for
+        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
         /// </summary>
         /// <param name="customizationId">The customization ID (GUID) of the custom language model that is to be used
         /// for the request. You must make the request with credentials for the instance of the service that owns the
@@ -2812,8 +2833,11 @@ public DetailedResponse<LanguageModel> GetLanguageModel(string customizationId)
         /// 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:** [Deleting a custom language
-        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#deleteModel-language).
+        /// **See also:**
+        /// * [Deleting a custom language
+        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#deleteModel-language)
+        /// * [Language support for
+        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
         /// </summary>
         /// <param name="customizationId">The customization ID (GUID) of the custom language model that is to be used
         /// for the request. You must make the request with credentials for the instance of the service that owns the
@@ -2877,8 +2901,11 @@ public DetailedResponse<object> DeleteLanguageModel(string customizationId)
         /// custom model is trained and ready to use. The service cannot accept subsequent training requests or requests
         /// to add new resources until the existing request completes.
         ///
-        /// **See also:** [Train the custom language
-        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#trainModel-language).
+        /// **See also:**
+        /// * [Train the custom language
+        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-languageCreate#trainModel-language)
+        /// * [Language support for
+        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support)
         ///
         /// ### Training failures
         ///
@@ -3007,8 +3034,11 @@ public class WordTypeToAddValue
         /// 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/speech-to-text?topic=speech-to-text-manageLanguageModels#resetModel-language).
+        /// **See also:**
+        /// * [Resetting a custom language
+        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageLanguageModels#resetModel-language)
+        /// * [Language support for
+        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
         /// </summary>
         /// <param name="customizationId">The customization ID (GUID) of the custom language model that is to be used
         /// for the request. You must make the request with credentials for the instance of the service that owns the
@@ -3071,8 +3101,11 @@ public DetailedResponse<object> ResetLanguageModel(string customizationId)
         /// model resumes the status that it had prior to upgrade. The service cannot accept subsequent requests for the
         /// model until the upgrade completes.
         ///
-        /// **See also:** [Upgrading a custom language
-        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-upgrade#custom-upgrade-language).
+        /// **See also:**
+        /// * [Upgrading a custom language
+        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-upgrade#custom-upgrade-language)
+        /// * [Language support for
+        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
         /// </summary>
         /// <param name="customizationId">The customization ID (GUID) of the custom language model that is to be used
         /// for the request. You must make the request with credentials for the instance of the service that owns the
@@ -3985,13 +4018,11 @@ public DetailedResponse<object> DeleteWord(string customizationId, string wordNa
         /// of out-of-vocabulary (OOV) words. You must use credentials for the instance of the service that owns a model
         /// to list its grammars.
         ///
-        /// **Availability:** Grammars are available only for some previous- and next-generation models. Support differs
-        /// between IBM Cloud and IBM Cloud Pak for Data. Grammars are generally available for some models and beta for
-        /// other models. For more information, see [Language support for
+        /// **See also:**
+        /// * [Listing grammars from a custom language
+        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars)
+        /// * [Language support for
         /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
-        ///
-        /// **See also:** [Listing grammars from a custom language
-        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
         /// </summary>
         /// <param name="customizationId">The customization ID (GUID) of the custom language model that is to be used
         /// for the request. You must make the request with credentials for the instance of the service that owns the
@@ -4071,16 +4102,13 @@ public DetailedResponse<Grammars> ListGrammars(string customizationId)
         /// you can add no more than 90 thousand OOV words to a model. This includes words that the service extracts
         /// from corpora and grammars and words that you add directly.
         ///
-        /// **Availability:** Grammars are available only for some previous- and next-generation models. Support differs
-        /// between IBM Cloud and IBM Cloud Pak for Data. Grammars are generally available for some models and beta for
-        /// other models. For more information, see [Language support for
-        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
-        ///
         /// **See also:**
         /// * [Understanding
         /// grammars](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-grammarUnderstand#grammarUnderstand)
         /// * [Add a grammar to the custom language
-        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-grammarAdd#addGrammar).
+        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-grammarAdd#addGrammar)
+        /// * [Language support for
+        /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
         /// </summary>
         /// <param name="customizationId">The customization ID (GUID) of the custom language model that is to be used
         /// for the request. You must make the request with credentials for the instance of the service that owns the
@@ -4156,7 +4184,8 @@ public DetailedResponse<object> AddGrammar(string customizationId, string gramma
                 {
                     restRequest.WithArgument("allow_overwrite", allowOverwrite);
                 }
-                var httpContent = new StringContent(Encoding.UTF8.GetString(grammarFile.ToArray()), Encoding.UTF8);
+                var httpContent = new ByteArrayContent(grammarFile.ToArray());
+                httpContent.Headers.Add("Content-Type", "application/srgs");
                 System.Net.Http.Headers.MediaTypeHeaderValue grammarFileContentType;
                 System.Net.Http.Headers.MediaTypeHeaderValue.TryParse(contentType, out grammarFileContentType);
                 httpContent.Headers.ContentType = grammarFileContentType;
@@ -4213,13 +4242,11 @@ public class ContentTypeValue
         /// out-of-vocabulary (OOV) words. You must use credentials for the instance of the service that owns a model to
         /// list its grammars.
         ///
-        /// **Availability:** Grammars are available only for some previous- and next-generation models. Support differs
-        /// between IBM Cloud and IBM Cloud Pak for Data. Grammars are generally available for some models and beta for
-        /// other models. For more information, see [Language support for
+        /// **See also:**
+        /// * [Listing grammars from a custom language
+        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars)
+        /// * [Language support for
         /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
-        ///
-        /// **See also:** [Listing grammars from a custom language
-        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#listGrammars).
         /// </summary>
         /// <param name="customizationId">The customization ID (GUID) of the custom language model that is to be used
         /// for the request. You must make the request with credentials for the instance of the service that owns the
@@ -4284,13 +4311,11 @@ public DetailedResponse<Grammar> GetGrammar(string customizationId, string gramm
         /// language model](#trainlanguagemodel) method. You must use credentials for the instance of the service that
         /// owns a model to delete its grammar.
         ///
-        /// **Availability:** Grammars are available only for some previous- and next-generation models. Support differs
-        /// between IBM Cloud and IBM Cloud Pak for Data. Grammars are generally available for some models and beta for
-        /// other models. For more information, see [Language support for
+        /// **See also:**
+        /// * [Deleting a grammar from a custom language
+        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#deleteGrammar)
+        /// * [Language support for
         /// customization](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-custom-support).
-        ///
-        /// **See also:** [Deleting a grammar from a custom language
-        /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-manageGrammars#deleteGrammar).
         /// </summary>
         /// <param name="customizationId">The customization ID (GUID) of the custom language model that is to be used
         /// for the request. You must make the request with credentials for the instance of the service that owns the
@@ -4360,8 +4385,8 @@ public DetailedResponse<object> DeleteGrammar(string customizationId, string gra
         /// **Important:** Effective 15 March 2022, previous-generation models for all languages other than Arabic and
         /// Japanese are deprecated. The deprecated models remain available until 15 September 2022, when they will be
         /// removed from the service and the documentation. You must migrate to the equivalent next-generation model by
-        /// the end of service date. For more information, see [Previous-generation languages and
-        /// models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models).
+        /// the end of service date. For more information, see [Migrating to next-generation
+        /// models](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-models-migrate).
         ///
         /// **See also:** [Create a custom acoustic
         /// model](https://cloud.ibm.com/docs/speech-to-text?topic=speech-to-text-acoustic#createModel-acoustic).