feat(text-to-speech-v1): new voices and languages added

new voices: ZH_CN_LINAVOICE, ZH_CN_WANGWEIVOICE, ZH_CN_ZHANGJINGVOICE, KO_KR_YOUNGMIVOICE, KO_KR_YUNAVOICE, NL_NL_EMMAVOICE, NL_NL_LIAMVOICE, EN_US_OLIVIAV3VOICE, EN_US_EMILYV3VOICE, EN_US_HENRYV3VOICE, EN_US_KEVINV3VOICE, DE_DE_ERIKAV3VOICE, AR_AR_OMARVOICE

new languages: ZH_CN, KO_KR, NL_NL, AR_AR

Author: dpopp07

text-to-speech/v1-generated.ts

@@ -33,7 +33,7 @@ import { getSdkHeaders } from '../lib/common';
  * 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).
+ * Phonetic Representation (SPR). The Arabic, Chinese, Dutch, and Korean languages support only IPA.
  */
 
 class TextToSpeechV1 extends BaseService {
@@ -265,9 +265,9 @@ class TextToSpeechV1 extends BaseService {
    * **Audio formats (accept types)** in the method description.
    * @param {string} [params.voice] - The voice to use for synthesis.
    * @param {string} [params.customizationId] - The customization ID (GUID) of a custom voice model to use for the
-   * synthesis. If a custom voice model is specified, it is guaranteed to work 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.
+   * synthesis. If a custom voice 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.
    * @param {OutgoingHttpHeaders} [params.headers] - Custom request headers
    * @param {Function} [callback] - The callback that handles the response
    * @returns {Promise<TextToSpeechV1.Response<NodeJS.ReadableStream|Buffer>>}
@@ -343,8 +343,7 @@ class TextToSpeechV1 extends BaseService {
    * 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. The method does not support the Arabic, Chinese, and Dutch
-   * languages.
+   * **Note:** This method is currently a beta release.
    *
    * **See also:** [Querying a word from a
    * language](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuWordsQueryLanguage).
@@ -353,8 +352,8 @@ class TextToSpeechV1 extends BaseService {
    * @param {string} params.text - The word for which the pronunciation is requested.
    * @param {string} [params.voice] - A voice that specifies the language in which the pronunciation is to be returned.
    * All voices for the same language (for example, `en-US`) return the same translation.
-   * @param {string} [params.format] - The phoneme format in which to return the pronunciation. Omit the parameter to
-   * obtain the pronunciation in the default format.
+   * @param {string} [params.format] - 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 {string} [params.customizationId] - 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
@@ -430,16 +429,16 @@ class TextToSpeechV1 extends BaseService {
    * 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. The service does not support voice model customization for the
-   * Arabic, Chinese, and Dutch languages.
+   * **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 {Object} params - The parameters to send to the service.
    * @param {string} params.name - The name of the new custom voice model.
-   * @param {string} [params.language] - The language of the new custom voice model. Omit the parameter to use the the
-   * default language, `en-US`.
+   * @param {string} [params.language] - 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 {string} [params.description] - A description of the new custom voice model. Specifying a description is
    * recommended.
    * @param {OutgoingHttpHeaders} [params.headers] - Custom request headers
@@ -1011,7 +1010,8 @@ class TextToSpeechV1 extends BaseService {
    * @param {string} params.word - The word that is to be added or updated for the custom voice model.
    * @param {string} params.translation - 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. A sounds-like is one or more words that, when combined, sound like the word.
+   * IBM SPR translation. The Arabic, Chinese, Dutch, and Korean languages support only IPA. A sounds-like is one or
+   * more words that, when combined, sound like the word.
    * @param {string} [params.partOfSpeech] - **Japanese only.** The part of speech for the word. The service uses the
    * value to produce the correct intonation for the word. You can create only a single entry, with or without a single
    * part of speech, for any word; you cannot create multiple entries with different parts of speech for the same word.
@@ -1351,18 +1351,24 @@ namespace TextToSpeechV1 {
   export namespace GetVoiceConstants {
     /** The voice for which information is to be returned. */
     export enum Voice {
+      AR_AR_OMARVOICE = 'ar-AR_OmarVoice',
       DE_DE_BIRGITVOICE = 'de-DE_BirgitVoice',
       DE_DE_BIRGITV3VOICE = 'de-DE_BirgitV3Voice',
       DE_DE_DIETERVOICE = 'de-DE_DieterVoice',
       DE_DE_DIETERV3VOICE = 'de-DE_DieterV3Voice',
+      DE_DE_ERIKAV3VOICE = 'de-DE_ErikaV3Voice',
       EN_GB_KATEVOICE = 'en-GB_KateVoice',
       EN_GB_KATEV3VOICE = 'en-GB_KateV3Voice',
       EN_US_ALLISONVOICE = 'en-US_AllisonVoice',
       EN_US_ALLISONV3VOICE = 'en-US_AllisonV3Voice',
+      EN_US_EMILYV3VOICE = 'en-US_EmilyV3Voice',
+      EN_US_HENRYV3VOICE = 'en-US_HenryV3Voice',
+      EN_US_KEVINV3VOICE = 'en-US_KevinV3Voice',
       EN_US_LISAVOICE = 'en-US_LisaVoice',
       EN_US_LISAV3VOICE = 'en-US_LisaV3Voice',
       EN_US_MICHAELVOICE = 'en-US_MichaelVoice',
       EN_US_MICHAELV3VOICE = 'en-US_MichaelV3Voice',
+      EN_US_OLIVIAV3VOICE = 'en-US_OliviaV3Voice',
       ES_ES_ENRIQUEVOICE = 'es-ES_EnriqueVoice',
       ES_ES_ENRIQUEV3VOICE = 'es-ES_EnriqueV3Voice',
       ES_ES_LAURAVOICE = 'es-ES_LauraVoice',
@@ -1377,8 +1383,15 @@ namespace TextToSpeechV1 {
       IT_IT_FRANCESCAV3VOICE = 'it-IT_FrancescaV3Voice',
       JA_JP_EMIVOICE = 'ja-JP_EmiVoice',
       JA_JP_EMIV3VOICE = 'ja-JP_EmiV3Voice',
+      KO_KR_YOUNGMIVOICE = 'ko-KR_YoungmiVoice',
+      KO_KR_YUNAVOICE = 'ko-KR_YunaVoice',
+      NL_NL_EMMAVOICE = 'nl-NL_EmmaVoice',
+      NL_NL_LIAMVOICE = 'nl-NL_LiamVoice',
       PT_BR_ISABELAVOICE = 'pt-BR_IsabelaVoice',
       PT_BR_ISABELAV3VOICE = 'pt-BR_IsabelaV3Voice',
+      ZH_CN_LINAVOICE = 'zh-CN_LiNaVoice',
+      ZH_CN_WANGWEIVOICE = 'zh-CN_WangWeiVoice',
+      ZH_CN_ZHANGJINGVOICE = 'zh-CN_ZhangJingVoice',
     }
   }
 
@@ -1394,9 +1407,9 @@ namespace TextToSpeechV1 {
     /** The voice to use for synthesis. */
     voice?: SynthesizeConstants.Voice | string;
     /** The customization ID (GUID) of a custom voice model to use for the synthesis. If a custom voice model is
-     *  specified, it is guaranteed to work 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.
+     *  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.
      */
     customizationId?: string;
     headers?: OutgoingHttpHeaders;
@@ -1427,14 +1440,19 @@ namespace TextToSpeechV1 {
       DE_DE_BIRGITV3VOICE = 'de-DE_BirgitV3Voice',
       DE_DE_DIETERVOICE = 'de-DE_DieterVoice',
       DE_DE_DIETERV3VOICE = 'de-DE_DieterV3Voice',
+      DE_DE_ERIKAV3VOICE = 'de-DE_ErikaV3Voice',
       EN_GB_KATEVOICE = 'en-GB_KateVoice',
       EN_GB_KATEV3VOICE = 'en-GB_KateV3Voice',
       EN_US_ALLISONVOICE = 'en-US_AllisonVoice',
       EN_US_ALLISONV3VOICE = 'en-US_AllisonV3Voice',
+      EN_US_EMILYV3VOICE = 'en-US_EmilyV3Voice',
+      EN_US_HENRYV3VOICE = 'en-US_HenryV3Voice',
+      EN_US_KEVINV3VOICE = 'en-US_KevinV3Voice',
       EN_US_LISAVOICE = 'en-US_LisaVoice',
       EN_US_LISAV3VOICE = 'en-US_LisaV3Voice',
       EN_US_MICHAELVOICE = 'en-US_MichaelVoice',
       EN_US_MICHAELV3VOICE = 'en-US_MichaelV3Voice',
+      EN_US_OLIVIAV3VOICE = 'en-US_OliviaV3Voice',
       ES_ES_ENRIQUEVOICE = 'es-ES_EnriqueVoice',
       ES_ES_ENRIQUEV3VOICE = 'es-ES_EnriqueV3Voice',
       ES_ES_LAURAVOICE = 'es-ES_LauraVoice',
@@ -1449,6 +1467,8 @@ namespace TextToSpeechV1 {
       IT_IT_FRANCESCAV3VOICE = 'it-IT_FrancescaV3Voice',
       JA_JP_EMIVOICE = 'ja-JP_EmiVoice',
       JA_JP_EMIV3VOICE = 'ja-JP_EmiV3Voice',
+      KO_KR_YOUNGMIVOICE = 'ko-KR_YoungmiVoice',
+      KO_KR_YUNAVOICE = 'ko-KR_YunaVoice',
       NL_NL_EMMAVOICE = 'nl-NL_EmmaVoice',
       NL_NL_LIAMVOICE = 'nl-NL_LiamVoice',
       PT_BR_ISABELAVOICE = 'pt-BR_IsabelaVoice',
@@ -1467,8 +1487,8 @@ namespace TextToSpeechV1 {
      *  language (for example, `en-US`) return the same translation.
      */
     voice?: GetPronunciationConstants.Voice | string;
-    /** The phoneme format in which to return the pronunciation. Omit the parameter to obtain the pronunciation in
-     *  the default format.
+    /** 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.
      */
     format?: GetPronunciationConstants.Format | string;
     /** The customization ID (GUID) of a custom voice model for which the pronunciation is to be returned. The
@@ -1485,18 +1505,24 @@ namespace TextToSpeechV1 {
   export namespace GetPronunciationConstants {
     /** A voice that specifies the language in which the pronunciation is to be returned. All voices for the same language (for example, `en-US`) return the same translation. */
     export enum Voice {
+      AR_AR_OMARVOICE = 'ar-AR_OmarVoice',
       DE_DE_BIRGITVOICE = 'de-DE_BirgitVoice',
       DE_DE_BIRGITV3VOICE = 'de-DE_BirgitV3Voice',
       DE_DE_DIETERVOICE = 'de-DE_DieterVoice',
       DE_DE_DIETERV3VOICE = 'de-DE_DieterV3Voice',
+      DE_DE_ERIKAV3VOICE = 'de-DE_ErikaV3Voice',
       EN_GB_KATEVOICE = 'en-GB_KateVoice',
       EN_GB_KATEV3VOICE = 'en-GB_KateV3Voice',
       EN_US_ALLISONVOICE = 'en-US_AllisonVoice',
       EN_US_ALLISONV3VOICE = 'en-US_AllisonV3Voice',
+      EN_US_EMILYV3VOICE = 'en-US_EmilyV3Voice',
+      EN_US_HENRYV3VOICE = 'en-US_HenryV3Voice',
+      EN_US_KEVINV3VOICE = 'en-US_KevinV3Voice',
       EN_US_LISAVOICE = 'en-US_LisaVoice',
       EN_US_LISAV3VOICE = 'en-US_LisaV3Voice',
       EN_US_MICHAELVOICE = 'en-US_MichaelVoice',
       EN_US_MICHAELV3VOICE = 'en-US_MichaelV3Voice',
+      EN_US_OLIVIAV3VOICE = 'en-US_OliviaV3Voice',
       ES_ES_ENRIQUEVOICE = 'es-ES_EnriqueVoice',
       ES_ES_ENRIQUEV3VOICE = 'es-ES_EnriqueV3Voice',
       ES_ES_LAURAVOICE = 'es-ES_LauraVoice',
@@ -1511,10 +1537,17 @@ namespace TextToSpeechV1 {
       IT_IT_FRANCESCAV3VOICE = 'it-IT_FrancescaV3Voice',
       JA_JP_EMIVOICE = 'ja-JP_EmiVoice',
       JA_JP_EMIV3VOICE = 'ja-JP_EmiV3Voice',
+      KO_KR_YOUNGMIVOICE = 'ko-KR_YoungmiVoice',
+      KO_KR_YUNAVOICE = 'ko-KR_YunaVoice',
+      NL_NL_EMMAVOICE = 'nl-NL_EmmaVoice',
+      NL_NL_LIAMVOICE = 'nl-NL_LiamVoice',
       PT_BR_ISABELAVOICE = 'pt-BR_IsabelaVoice',
       PT_BR_ISABELAV3VOICE = 'pt-BR_IsabelaV3Voice',
+      ZH_CN_LINAVOICE = 'zh-CN_LiNaVoice',
+      ZH_CN_WANGWEIVOICE = 'zh-CN_WangWeiVoice',
+      ZH_CN_ZHANGJINGVOICE = 'zh-CN_ZhangJingVoice',
     }
-    /** The phoneme format in which to return the pronunciation. Omit the parameter to obtain the pronunciation in the default format. */
+    /** 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. */
     export enum Format {
       IBM = 'ibm',
       IPA = 'ipa',
@@ -1525,7 +1558,10 @@ namespace TextToSpeechV1 {
   export interface CreateVoiceModelParams {
     /** The name of the new custom voice model. */
     name: string;
-    /** The language of the new custom voice model. Omit the parameter to use the the default language, `en-US`. */
+    /** 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`.
+     */
     language?: CreateVoiceModelConstants.Language | string;
     /** A description of the new custom voice model. Specifying a description is recommended. */
     description?: string;
@@ -1534,8 +1570,9 @@ namespace TextToSpeechV1 {
 
   /** Constants for the `createVoiceModel` operation. */
   export namespace CreateVoiceModelConstants {
-    /** The language of the new custom voice model. Omit the parameter to use the the default language, `en-US`. */
+    /** 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`. */
     export enum Language {
+      AR_AR = 'ar-AR',
       DE_DE = 'de-DE',
       EN_GB = 'en-GB',
       EN_US = 'en-US',
@@ -1545,7 +1582,10 @@ namespace TextToSpeechV1 {
       FR_FR = 'fr-FR',
       IT_IT = 'it-IT',
       JA_JP = 'ja-JP',
+      KO_KR = 'ko-KR',
+      NL_NL = 'nl-NL',
       PT_BR = 'pt-BR',
+      ZH_CN = 'zh-CN',
     }
   }
 
@@ -1562,6 +1602,7 @@ namespace TextToSpeechV1 {
   export namespace ListVoiceModelsConstants {
     /** 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. */
     export enum Language {
+      AR_AR = 'ar-AR',
       DE_DE = 'de-DE',
       EN_GB = 'en-GB',
       EN_US = 'en-US',
@@ -1571,7 +1612,10 @@ namespace TextToSpeechV1 {
       FR_FR = 'fr-FR',
       IT_IT = 'it-IT',
       JA_JP = 'ja-JP',
+      KO_KR = 'ko-KR',
+      NL_NL = 'nl-NL',
       PT_BR = 'pt-BR',
+      ZH_CN = 'zh-CN',
     }
   }
 
@@ -1645,8 +1689,9 @@ namespace TextToSpeechV1 {
     /** The word that is to be added or updated for the custom voice model. */
     word: 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. A
-     *  sounds-like is one or more words that, when combined, sound like the word.
+     *  representing the phonetic string of a word either as an IPA translation or as an IBM SPR translation. The
+     *  Arabic, Chinese, Dutch, and Korean languages support only IPA. A sounds-like is one or more words that, when
+     *  combined, sound like the word.
      */
     translation: string;
     /** **Japanese only.** The part of speech for the word. The service uses the value to produce the correct
@@ -1739,8 +1784,9 @@ namespace TextToSpeechV1 {
   /** Information about the translation for the specified text. */
   export interface Translation {
     /** 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. A
-     *  sounds-like is one or more words that, when combined, sound like the word.
+     *  representing the phonetic string of a word either as an IPA translation or as an IBM SPR translation. The
+     *  Arabic, Chinese, Dutch, and Korean languages support only IPA. A sounds-like is one or more words that, when
+     *  combined, sound like the word.
      */
     translation: string;
     /** **Japanese only.** The part of speech for the word. The service uses the value to produce the correct
@@ -1824,11 +1870,12 @@ namespace TextToSpeechV1 {
 
   /** Information about a word for the custom voice model. */
   export interface Word {
-    /** The word for the custom voice model. */
+    /** The word for the custom voice model. The maximum length of a word is 49 characters. */
     word: 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 or IBM SPR translation. A sounds-like translation
-     *  consists of one or more words that, when combined, sound like the word.
+     *  representing the phonetic string of a word either as an IPA or IBM SPR translation. The Arabic, Chinese, Dutch,
+     *  and Korean languages support only IPA. A sounds-like translation consists of one or more words that, when
+     *  combined, sound like the word. The maximum length of a translation is 499 characters.
      */
     translation: string;
     /** **Japanese only.** The part of speech for the word. The service uses the value to produce the correct