|
1 | 1 | /*
|
2 |
| - * (C) Copyright IBM Corp. 2019, 2021. |
| 2 | + * (C) Copyright IBM Corp. 2022. |
3 | 3 | *
|
4 | 4 | * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
|
5 | 5 | * the License. You may obtain a copy of the License at
|
|
12 | 12 | */
|
13 | 13 |
|
14 | 14 | /*
|
15 |
| - * IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025 |
| 15 | + * IBM OpenAPI SDK Code Generator Version: 3.46.0-a4e29da0-20220224-210428 |
16 | 16 | */
|
17 | 17 |
|
18 | 18 | package com.ibm.watson.text_to_speech.v1;
|
|
91 | 91 | * when combined, sound like the word. A phonetic translation is based on the SSML phoneme format
|
92 | 92 | * for representing a word. You can specify a phonetic translation in standard International
|
93 | 93 | * Phonetic Alphabet (IPA) representation or in the proprietary IBM Symbolic Phonetic Representation
|
94 |
| - * (SPR). |
| 94 | + * (SPR). For phonetic translation, the Arabic, Chinese, Dutch, Australian English, Korean, and |
| 95 | + * Swedish voices support only IPA, not SPR. |
95 | 96 | *
|
96 | 97 | * <p>The service also offers a Tune by Example feature that lets you define custom prompts. You can
|
97 | 98 | * also define speaker models to improve the quality of your custom prompts. The service support
|
98 | 99 | * custom prompts only for US English custom models and voices.
|
99 | 100 | *
|
100 |
| - * <p>**IBM Cloud&reg;.** The Arabic, Chinese, Dutch, Australian English, and Korean languages |
101 |
| - * and voices are supported only for IBM Cloud. For phonetic translation, they support only IPA, not |
102 |
| - * SPR. |
103 |
| - * |
104 | 101 | * <p>API Version: 1.0.0 See: https://cloud.ibm.com/docs/text-to-speech
|
105 | 102 | */
|
106 | 103 | public class TextToSpeech extends BaseService {
|
@@ -209,25 +206,10 @@ public ServiceCall<Voices> listVoices() {
|
209 | 206 | * <p>**See also:** [Listing a specific
|
210 | 207 | * voice](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-voices#listVoice).
|
211 | 208 | *
|
212 |
| - * <p>### Important voice updates for IBM Cloud |
213 |
| - * |
214 |
| - * <p>The service's voices underwent significant change on 2 December 2020. * The Arabic, Chinese, |
215 |
| - * Dutch, Australian English, and Korean voices are now neural instead of concatenative. * The |
216 |
| - * `ar-AR_OmarVoice` voice is deprecated. Use `ar-MS_OmarVoice` voice instead. * The `ar-AR` |
217 |
| - * language identifier cannot be used to create a custom model. Use the `ar-MS` identifier |
218 |
| - * instead. * The standard concatenative voices for the following languages are now deprecated: |
219 |
| - * Brazilian Portuguese, United Kingdom and United States English, French, German, Italian, |
220 |
| - * Japanese, and Spanish (all dialects). * The features expressive SSML, voice transformation |
221 |
| - * SSML, and use of the `volume` attribute of the `<prosody>` element are deprecated and are |
222 |
| - * not supported with any of the service's neural voices. * All of the service's voices are now |
223 |
| - * customizable and generally available (GA) for production use. |
224 |
| - * |
225 |
| - * <p>The deprecated voices and features will continue to function for at least one year but might |
226 |
| - * be removed at a future date. You are encouraged to migrate to the equivalent neural voices at |
227 |
| - * your earliest convenience. For more information about all voice updates, see the [2 December |
228 |
| - * 2020 service |
229 |
| - * update](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-release-notes#December2020) |
230 |
| - * in the release notes for IBM Cloud. |
| 209 | + * <p>**Note:** The Arabic, Chinese, Czech, Dutch (Belgian and Netherlands), Australian English, |
| 210 | + * Korean, and Swedish languages and voices are supported only for IBM Cloud; they are deprecated |
| 211 | + * for IBM Cloud Pak for Data. Also, the `ar-AR_OmarVoice` voice is deprecated; use the |
| 212 | + * `ar-MS_OmarVoice` voice instead. |
231 | 213 | *
|
232 | 214 | * @param getVoiceOptions the {@link GetVoiceOptions} containing the options for the call
|
233 | 215 | * @return a {@link ServiceCall} with a result of type {@link Voice}
|
@@ -268,6 +250,11 @@ public ServiceCall<Voice> getVoice(GetVoiceOptions getVoiceOptions) {
|
268 | 250 | * <p>**See also:** [The HTTP
|
269 | 251 | * interface](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-usingHTTP#usingHTTP).
|
270 | 252 | *
|
| 253 | + * <p>**Note:** The Arabic, Chinese, Czech, Dutch (Belgian and Netherlands), Australian English, |
| 254 | + * Korean, and Swedish languages and voices are supported only for IBM Cloud; they are deprecated |
| 255 | + * for IBM Cloud Pak for Data. Also, the `ar-AR_OmarVoice` voice is deprecated; use the |
| 256 | + * `ar-MS_OmarVoice` voice instead. |
| 257 | + * |
271 | 258 | * <p>### Audio formats (accept types)
|
272 | 259 | *
|
273 | 260 | * <p>The service can return audio in the following formats (MIME types). * Where indicated, you
|
@@ -303,26 +290,6 @@ public ServiceCall<Voice> getVoice(GetVoiceOptions getVoiceOptions) {
|
303 | 290 | * some of the formats, see [Using audio
|
304 | 291 | * formats](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-audio-formats).
|
305 | 292 | *
|
306 |
| - * <p>### Important voice updates for IBM Cloud |
307 |
| - * |
308 |
| - * <p>The service's voices underwent significant change on 2 December 2020. * The Arabic, Chinese, |
309 |
| - * Dutch, Australian English, and Korean voices are now neural instead of concatenative. * The |
310 |
| - * `ar-AR_OmarVoice` voice is deprecated. Use `ar-MS_OmarVoice` voice instead. * The `ar-AR` |
311 |
| - * language identifier cannot be used to create a custom model. Use the `ar-MS` identifier |
312 |
| - * instead. * The standard concatenative voices for the following languages are now deprecated: |
313 |
| - * Brazilian Portuguese, United Kingdom and United States English, French, German, Italian, |
314 |
| - * Japanese, and Spanish (all dialects). * The features expressive SSML, voice transformation |
315 |
| - * SSML, and use of the `volume` attribute of the `<prosody>` element are deprecated and are |
316 |
| - * not supported with any of the service's neural voices. * All of the service's voices are now |
317 |
| - * customizable and generally available (GA) for production use. |
318 |
| - * |
319 |
| - * <p>The deprecated voices and features will continue to function for at least one year but might |
320 |
| - * be removed at a future date. You are encouraged to migrate to the equivalent neural voices at |
321 |
| - * your earliest convenience. For more information about all voice updates, see the [2 December |
322 |
| - * 2020 service |
323 |
| - * update](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-release-notes#December2020) |
324 |
| - * in the release notes for IBM Cloud. |
325 |
| - * |
326 | 293 | * <p>### Warning messages
|
327 | 294 | *
|
328 | 295 | * <p>If a request includes invalid query parameters, the service returns a `Warnings` response
|
@@ -417,25 +384,10 @@ public WebSocket synthesizeUsingWebSocket(
|
417 | 384 | * <p>**See also:** [Querying a word from a
|
418 | 385 | * language](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customWords#cuWordsQueryLanguage).
|
419 | 386 | *
|
420 |
| - * <p>### Important voice updates for IBM Cloud |
421 |
| - * |
422 |
| - * <p>The service's voices underwent significant change on 2 December 2020. * The Arabic, Chinese, |
423 |
| - * Dutch, Australian English, and Korean voices are now neural instead of concatenative. * The |
424 |
| - * `ar-AR_OmarVoice` voice is deprecated. Use `ar-MS_OmarVoice` voice instead. * The `ar-AR` |
425 |
| - * language identifier cannot be used to create a custom model. Use the `ar-MS` identifier |
426 |
| - * instead. * The standard concatenative voices for the following languages are now deprecated: |
427 |
| - * Brazilian Portuguese, United Kingdom and United States English, French, German, Italian, |
428 |
| - * Japanese, and Spanish (all dialects). * The features expressive SSML, voice transformation |
429 |
| - * SSML, and use of the `volume` attribute of the `<prosody>` element are deprecated and are |
430 |
| - * not supported with any of the service's neural voices. * All of the service's voices are now |
431 |
| - * customizable and generally available (GA) for production use. |
432 |
| - * |
433 |
| - * <p>The deprecated voices and features will continue to function for at least one year but might |
434 |
| - * be removed at a future date. You are encouraged to migrate to the equivalent neural voices at |
435 |
| - * your earliest convenience. For more information about all voice updates, see the [2 December |
436 |
| - * 2020 service |
437 |
| - * update](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-release-notes#December2020) |
438 |
| - * in the release notes for IBM Cloud. |
| 387 | + * <p>**Note:** The Arabic, Chinese, Czech, Dutch (Belgian and Netherlands), Australian English, |
| 388 | + * Korean, and Swedish languages and voices are supported only for IBM Cloud; they are deprecated |
| 389 | + * for IBM Cloud Pak for Data. Also, the `ar-AR_OmarVoice` voice is deprecated; use the |
| 390 | + * `ar-MS_OmarVoice` voice instead. |
439 | 391 | *
|
440 | 392 | * @param getPronunciationOptions the {@link GetPronunciationOptions} containing the options for
|
441 | 393 | * the call
|
@@ -479,25 +431,10 @@ public ServiceCall<Pronunciation> getPronunciation(
|
479 | 431 | * <p>**See also:** [Creating a custom
|
480 | 432 | * model](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-customModels#cuModelsCreate).
|
481 | 433 | *
|
482 |
| - * <p>### Important voice updates for IBM Cloud |
483 |
| - * |
484 |
| - * <p>The service's voices underwent significant change on 2 December 2020. * The Arabic, Chinese, |
485 |
| - * Dutch, Australian English, and Korean voices are now neural instead of concatenative. * The |
486 |
| - * `ar-AR_OmarVoice` voice is deprecated. Use `ar-MS_OmarVoice` voice instead. * The `ar-AR` |
487 |
| - * language identifier cannot be used to create a custom model. Use the `ar-MS` identifier |
488 |
| - * instead. * The standard concatenative voices for the following languages are now deprecated: |
489 |
| - * Brazilian Portuguese, United Kingdom and United States English, French, German, Italian, |
490 |
| - * Japanese, and Spanish (all dialects). * The features expressive SSML, voice transformation |
491 |
| - * SSML, and use of the `volume` attribute of the `<prosody>` element are deprecated and are |
492 |
| - * not supported with any of the service's neural voices. * All of the service's voices are now |
493 |
| - * customizable and generally available (GA) for production use. |
494 |
| - * |
495 |
| - * <p>The deprecated voices and features will continue to function for at least one year but might |
496 |
| - * be removed at a future date. You are encouraged to migrate to the equivalent neural voices at |
497 |
| - * your earliest convenience. For more information about all voice updates, see the [2 December |
498 |
| - * 2020 service |
499 |
| - * update](https://cloud.ibm.com/docs/text-to-speech?topic=text-to-speech-release-notes#December2020) |
500 |
| - * in the release notes for IBM Cloud. |
| 434 | + * <p>**Note:** The Arabic, Chinese, Czech, Dutch (Belgian and Netherlands), Australian English, |
| 435 | + * Korean, and Swedish languages and voices are supported only for IBM Cloud; they are deprecated |
| 436 | + * for IBM Cloud Pak for Data. Also, the `ar-AR` language identifier cannot be used to create a |
| 437 | + * custom model; use the `ar-MS` identifier instead. |
501 | 438 | *
|
502 | 439 | * @param createCustomModelOptions the {@link CreateCustomModelOptions} containing the options for
|
503 | 440 | * the call
|
|
0 commit comments