@@ -20,9 +20,10 @@ import { Authenticator, BaseService, getAuthenticatorFromEnvironment, getMissing
2020import { getSdkHeaders } from '../lib/common' ;
2121
2222/**
23- * The IBM® Text to Speech service provides APIs that use IBM's speech-synthesis capabilities to synthesize text
24- * into natural-sounding speech in a variety of languages, dialects, and voices. The service supports at least one male
25- * or female voice, sometimes both, for each language. The audio is streamed back to the client with minimal delay.
23+ * The IBM Watson™ Text to Speech service provides APIs that use IBM's speech-synthesis capabilities to synthesize
24+ * text into natural-sounding speech in a variety of languages, dialects, and voices. The service supports at least one
25+ * male or female voice, sometimes both, for each language. The audio is streamed back to the client with minimal delay.
26+ *
2627 *
2728 * For speech synthesis, the service supports a synchronous HTTP Representational State Transfer (REST) interface and a
2829 * WebSocket interface. Both interfaces support plain text and SSML input. SSML is an XML-based markup language that
@@ -38,14 +39,14 @@ import { getSdkHeaders } from '../lib/common';
3839
3940class TextToSpeechV1 extends BaseService {
4041
41- static DEFAULT_SERVICE_URL : string = 'https://stream.watsonplatform.net/ text-to-speech/api ' ;
42+ static DEFAULT_SERVICE_URL : string = 'https://api.us-south. text-to-speech.watson.cloud.ibm.com ' ;
4243 static DEFAULT_SERVICE_NAME : string = 'text_to_speech' ;
4344
4445 /**
4546 * Construct a TextToSpeechV1 object.
4647 *
4748 * @param {Object } options - Options for the service.
48- * @param {string } [options.serviceUrl] - The base url to use when contacting the service (e.g. 'https://gateway.watsonplatform.net/text-to-speech/api '). The base url may differ between IBM Cloud regions.
49+ * @param {string } [options.serviceUrl] - The base url to use when contacting the service (e.g. 'https://gateway.watsonplatform.net'). The base url may differ between IBM Cloud regions.
4950 * @param {OutgoingHttpHeaders } [options.headers] - Default headers that shall be included with every request to the service.
5051 * @param {string } [options.serviceName] - The name of the service to configure
5152 * @param {Authenticator } [options.authenticator] - The Authenticator object used to authenticate requests to the service. Defaults to environment if not set
@@ -75,7 +76,8 @@ class TextToSpeechV1 extends BaseService {
7576 * List voices.
7677 *
7778 * Lists all voices available for use with the service. The information includes the name, language, gender, and other
78- * details about the voice. To see information about a specific voice, use the **Get a voice** method.
79+ * details about the voice. The ordering of the list of voices can change from call to call; do not rely on an
80+ * alphabetized or static list of voices. To see information about a specific voice, use the **Get a voice** method.
7981 *
8082 * **See also:** [Listing all available
8183 * voices](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-voices#listVoices).
@@ -1234,10 +1236,12 @@ class TextToSpeechV1 extends BaseService {
12341236 * Deletes all data that is associated with a specified customer ID. The method deletes all data for the customer ID,
12351237 * regardless of the method by which the information was added. The method has no effect if no data is associated with
12361238 * the customer ID. You must issue the request with credentials for the same instance of the service that was used to
1237- * associate the customer ID with the data.
1239+ * associate the customer ID with the data. You associate a customer ID with data by passing the `X-Watson-Metadata`
1240+ * header with a request that passes the data.
12381241 *
1239- * You associate a customer ID with data by passing the `X-Watson-Metadata` header with a request that passes the
1240- * data.
1242+ * **Note:** If you delete an instance of the service from the service console, all data associated with that service
1243+ * instance is automatically deleted. This includes all custom voice models and word/translation pairs, and all data
1244+ * related to speech synthesis requests.
12411245 *
12421246 * **See also:** [Information
12431247 * security](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-information-security#information-security).
@@ -1357,6 +1361,8 @@ namespace TextToSpeechV1 {
13571361 DE_DE_DIETERVOICE = 'de-DE_DieterVoice' ,
13581362 DE_DE_DIETERV3VOICE = 'de-DE_DieterV3Voice' ,
13591363 DE_DE_ERIKAV3VOICE = 'de-DE_ErikaV3Voice' ,
1364+ EN_GB_CHARLOTTEV3VOICE = 'en-GB_CharlotteV3Voice' ,
1365+ EN_GB_JAMESV3VOICE = 'en-GB_JamesV3Voice' ,
13601366 EN_GB_KATEVOICE = 'en-GB_KateVoice' ,
13611367 EN_GB_KATEV3VOICE = 'en-GB_KateV3Voice' ,
13621368 EN_US_ALLISONVOICE = 'en-US_AllisonVoice' ,
@@ -1377,6 +1383,7 @@ namespace TextToSpeechV1 {
13771383 ES_LA_SOFIAV3VOICE = 'es-LA_SofiaV3Voice' ,
13781384 ES_US_SOFIAVOICE = 'es-US_SofiaVoice' ,
13791385 ES_US_SOFIAV3VOICE = 'es-US_SofiaV3Voice' ,
1386+ FR_FR_NICOLASV3VOICE = 'fr-FR_NicolasV3Voice' ,
13801387 FR_FR_RENEEVOICE = 'fr-FR_ReneeVoice' ,
13811388 FR_FR_RENEEV3VOICE = 'fr-FR_ReneeV3Voice' ,
13821389 IT_IT_FRANCESCAVOICE = 'it-IT_FrancescaVoice' ,
@@ -1441,6 +1448,8 @@ namespace TextToSpeechV1 {
14411448 DE_DE_DIETERVOICE = 'de-DE_DieterVoice' ,
14421449 DE_DE_DIETERV3VOICE = 'de-DE_DieterV3Voice' ,
14431450 DE_DE_ERIKAV3VOICE = 'de-DE_ErikaV3Voice' ,
1451+ EN_GB_CHARLOTTEV3VOICE = 'en-GB_CharlotteV3Voice' ,
1452+ EN_GB_JAMESV3VOICE = 'en-GB_JamesV3Voice' ,
14441453 EN_GB_KATEVOICE = 'en-GB_KateVoice' ,
14451454 EN_GB_KATEV3VOICE = 'en-GB_KateV3Voice' ,
14461455 EN_US_ALLISONVOICE = 'en-US_AllisonVoice' ,
@@ -1461,6 +1470,7 @@ namespace TextToSpeechV1 {
14611470 ES_LA_SOFIAV3VOICE = 'es-LA_SofiaV3Voice' ,
14621471 ES_US_SOFIAVOICE = 'es-US_SofiaVoice' ,
14631472 ES_US_SOFIAV3VOICE = 'es-US_SofiaV3Voice' ,
1473+ FR_FR_NICOLASV3VOICE = 'fr-FR_NicolasV3Voice' ,
14641474 FR_FR_RENEEVOICE = 'fr-FR_ReneeVoice' ,
14651475 FR_FR_RENEEV3VOICE = 'fr-FR_ReneeV3Voice' ,
14661476 IT_IT_FRANCESCAVOICE = 'it-IT_FrancescaVoice' ,
@@ -1511,6 +1521,8 @@ namespace TextToSpeechV1 {
15111521 DE_DE_DIETERVOICE = 'de-DE_DieterVoice' ,
15121522 DE_DE_DIETERV3VOICE = 'de-DE_DieterV3Voice' ,
15131523 DE_DE_ERIKAV3VOICE = 'de-DE_ErikaV3Voice' ,
1524+ EN_GB_CHARLOTTEV3VOICE = 'en-GB_CharlotteV3Voice' ,
1525+ EN_GB_JAMESV3VOICE = 'en-GB_JamesV3Voice' ,
15141526 EN_GB_KATEVOICE = 'en-GB_KateVoice' ,
15151527 EN_GB_KATEV3VOICE = 'en-GB_KateV3Voice' ,
15161528 EN_US_ALLISONVOICE = 'en-US_AllisonVoice' ,
@@ -1531,6 +1543,7 @@ namespace TextToSpeechV1 {
15311543 ES_LA_SOFIAV3VOICE = 'es-LA_SofiaV3Voice' ,
15321544 ES_US_SOFIAVOICE = 'es-US_SofiaVoice' ,
15331545 ES_US_SOFIAV3VOICE = 'es-US_SofiaV3Voice' ,
1546+ FR_FR_NICOLASV3VOICE = 'fr-FR_NicolasV3Voice' ,
15341547 FR_FR_RENEEVOICE = 'fr-FR_ReneeVoice' ,
15351548 FR_FR_RENEEV3VOICE = 'fr-FR_ReneeV3Voice' ,
15361549 IT_IT_FRANCESCAVOICE = 'it-IT_FrancescaVoice' ,
0 commit comments