From 367e933587f67349c5a69f98fd3cd515759caef1 Mon Sep 17 00:00:00 2001 From: awstools Date: Thu, 16 Nov 2023 19:22:02 +0000 Subject: [PATCH] feat(client-polly): Add new engine - long-form - dedicated for longer content, such as news articles, training materials, or marketing videos. --- .../src/commands/DescribeVoicesCommand.ts | 4 +- .../commands/GetSpeechSynthesisTaskCommand.ts | 2 +- .../ListSpeechSynthesisTasksCommand.ts | 2 +- .../StartSpeechSynthesisTaskCommand.ts | 4 +- .../src/commands/SynthesizeSpeechCommand.ts | 2 +- clients/client-polly/src/models/models_0.ts | 53 ++++++++++++------- codegen/sdk-codegen/aws-models/polly.json | 22 +++++--- 7 files changed, 54 insertions(+), 35 deletions(-) diff --git a/clients/client-polly/src/commands/DescribeVoicesCommand.ts b/clients/client-polly/src/commands/DescribeVoicesCommand.ts index 740a7b02530d..c58102739075 100644 --- a/clients/client-polly/src/commands/DescribeVoicesCommand.ts +++ b/clients/client-polly/src/commands/DescribeVoicesCommand.ts @@ -60,7 +60,7 @@ export interface DescribeVoicesCommandOutput extends DescribeVoicesOutput, __Met * // const { PollyClient, DescribeVoicesCommand } = require("@aws-sdk/client-polly"); // CommonJS import * const client = new PollyClient(config); * const input = { // DescribeVoicesInput - * Engine: "standard" || "neural", + * Engine: "standard" || "neural" || "long-form", * LanguageCode: "arb" || "cmn-CN" || "cy-GB" || "da-DK" || "de-DE" || "en-AU" || "en-GB" || "en-GB-WLS" || "en-IN" || "en-US" || "es-ES" || "es-MX" || "es-US" || "fr-CA" || "fr-FR" || "is-IS" || "it-IT" || "ja-JP" || "hi-IN" || "ko-KR" || "nb-NO" || "nl-NL" || "pl-PL" || "pt-BR" || "pt-PT" || "ro-RO" || "ru-RU" || "sv-SE" || "tr-TR" || "en-NZ" || "en-ZA" || "ca-ES" || "de-AT" || "yue-CN" || "ar-AE" || "fi-FI" || "en-IE" || "nl-BE" || "fr-BE", * IncludeAdditionalLanguageCodes: true || false, * NextToken: "STRING_VALUE", @@ -79,7 +79,7 @@ export interface DescribeVoicesCommandOutput extends DescribeVoicesOutput, __Met * // "arb" || "cmn-CN" || "cy-GB" || "da-DK" || "de-DE" || "en-AU" || "en-GB" || "en-GB-WLS" || "en-IN" || "en-US" || "es-ES" || "es-MX" || "es-US" || "fr-CA" || "fr-FR" || "is-IS" || "it-IT" || "ja-JP" || "hi-IN" || "ko-KR" || "nb-NO" || "nl-NL" || "pl-PL" || "pt-BR" || "pt-PT" || "ro-RO" || "ru-RU" || "sv-SE" || "tr-TR" || "en-NZ" || "en-ZA" || "ca-ES" || "de-AT" || "yue-CN" || "ar-AE" || "fi-FI" || "en-IE" || "nl-BE" || "fr-BE", * // ], * // SupportedEngines: [ // EngineList - * // "standard" || "neural", + * // "standard" || "neural" || "long-form", * // ], * // }, * // ], diff --git a/clients/client-polly/src/commands/GetSpeechSynthesisTaskCommand.ts b/clients/client-polly/src/commands/GetSpeechSynthesisTaskCommand.ts index 75f4ac8970bf..ed189734e9b6 100644 --- a/clients/client-polly/src/commands/GetSpeechSynthesisTaskCommand.ts +++ b/clients/client-polly/src/commands/GetSpeechSynthesisTaskCommand.ts @@ -54,7 +54,7 @@ export interface GetSpeechSynthesisTaskCommandOutput extends GetSpeechSynthesisT * const response = await client.send(command); * // { // GetSpeechSynthesisTaskOutput * // SynthesisTask: { // SynthesisTask - * // Engine: "standard" || "neural", + * // Engine: "standard" || "neural" || "long-form", * // TaskId: "STRING_VALUE", * // TaskStatus: "scheduled" || "inProgress" || "completed" || "failed", * // TaskStatusReason: "STRING_VALUE", diff --git a/clients/client-polly/src/commands/ListSpeechSynthesisTasksCommand.ts b/clients/client-polly/src/commands/ListSpeechSynthesisTasksCommand.ts index 400454001015..cbfa9a91daed 100644 --- a/clients/client-polly/src/commands/ListSpeechSynthesisTasksCommand.ts +++ b/clients/client-polly/src/commands/ListSpeechSynthesisTasksCommand.ts @@ -57,7 +57,7 @@ export interface ListSpeechSynthesisTasksCommandOutput extends ListSpeechSynthes * // NextToken: "STRING_VALUE", * // SynthesisTasks: [ // SynthesisTasks * // { // SynthesisTask - * // Engine: "standard" || "neural", + * // Engine: "standard" || "neural" || "long-form", * // TaskId: "STRING_VALUE", * // TaskStatus: "scheduled" || "inProgress" || "completed" || "failed", * // TaskStatusReason: "STRING_VALUE", diff --git a/clients/client-polly/src/commands/StartSpeechSynthesisTaskCommand.ts b/clients/client-polly/src/commands/StartSpeechSynthesisTaskCommand.ts index eeeaf2b5a5fc..03572ef38119 100644 --- a/clients/client-polly/src/commands/StartSpeechSynthesisTaskCommand.ts +++ b/clients/client-polly/src/commands/StartSpeechSynthesisTaskCommand.ts @@ -54,7 +54,7 @@ export interface StartSpeechSynthesisTaskCommandOutput extends StartSpeechSynthe * // const { PollyClient, StartSpeechSynthesisTaskCommand } = require("@aws-sdk/client-polly"); // CommonJS import * const client = new PollyClient(config); * const input = { // StartSpeechSynthesisTaskInput - * Engine: "standard" || "neural", + * Engine: "standard" || "neural" || "long-form", * LanguageCode: "arb" || "cmn-CN" || "cy-GB" || "da-DK" || "de-DE" || "en-AU" || "en-GB" || "en-GB-WLS" || "en-IN" || "en-US" || "es-ES" || "es-MX" || "es-US" || "fr-CA" || "fr-FR" || "is-IS" || "it-IT" || "ja-JP" || "hi-IN" || "ko-KR" || "nb-NO" || "nl-NL" || "pl-PL" || "pt-BR" || "pt-PT" || "ro-RO" || "ru-RU" || "sv-SE" || "tr-TR" || "en-NZ" || "en-ZA" || "ca-ES" || "de-AT" || "yue-CN" || "ar-AE" || "fi-FI" || "en-IE" || "nl-BE" || "fr-BE", * LexiconNames: [ // LexiconNameList * "STRING_VALUE", @@ -75,7 +75,7 @@ export interface StartSpeechSynthesisTaskCommandOutput extends StartSpeechSynthe * const response = await client.send(command); * // { // StartSpeechSynthesisTaskOutput * // SynthesisTask: { // SynthesisTask - * // Engine: "standard" || "neural", + * // Engine: "standard" || "neural" || "long-form", * // TaskId: "STRING_VALUE", * // TaskStatus: "scheduled" || "inProgress" || "completed" || "failed", * // TaskStatusReason: "STRING_VALUE", diff --git a/clients/client-polly/src/commands/SynthesizeSpeechCommand.ts b/clients/client-polly/src/commands/SynthesizeSpeechCommand.ts index 6802a4776586..fba9e84a9f66 100644 --- a/clients/client-polly/src/commands/SynthesizeSpeechCommand.ts +++ b/clients/client-polly/src/commands/SynthesizeSpeechCommand.ts @@ -57,7 +57,7 @@ export interface SynthesizeSpeechCommandOutput extends OmitSpecifies the engine (standard or neural) - * used by Amazon Polly when processing input text for speech synthesis.

+ *

Specifies the engine (standard, neural or + * long-form) used by Amazon Polly when processing input text for + * speech synthesis.

*/ Engine?: Engine; @@ -342,8 +344,8 @@ export interface Voice { /** * @public - *

Specifies which engines (standard or neural) - * that are supported by a given voice.

+ *

Specifies which engines (standard, neural or + * long-form) are supported by a given voice.

*/ SupportedEngines?: Engine[]; } @@ -589,10 +591,10 @@ export type TextType = (typeof TextType)[keyof typeof TextType]; export interface SynthesisTask { /** * @public - *

Specifies the engine (standard or neural) - * for Amazon Polly to use when processing input text for speech synthesis. Using a - * voice that is not supported for the engine selected will result in an - * error.

+ *

Specifies the engine (standard, neural or + * long-form) for Amazon Polly to use when processing input text for + * speech synthesis. Using a voice that is not supported for the engine + * selected will result in an error.

*/ Engine?: Engine; @@ -661,7 +663,8 @@ export interface SynthesisTask { *

The audio frequency specified in Hz.

*

The valid values for mp3 and ogg_vorbis are "8000", "16000", "22050", * and "24000". The default value for standard voices is "22050". The default - * value for neural voices is "24000".

+ * value for neural voices is "24000". The default value for long-form voices + * is "24000".

*

Valid values for pcm are "8000" and "16000" The default value is * "16000".

*/ @@ -1176,10 +1179,10 @@ export class SsmlMarksNotSupportedForTextTypeException extends __BaseException { export interface StartSpeechSynthesisTaskInput { /** * @public - *

Specifies the engine (standard or neural) - * for Amazon Polly to use when processing input text for speech synthesis. Using a - * voice that is not supported for the engine selected will result in an - * error.

+ *

Specifies the engine (standard, neural or + * long-form) for Amazon Polly to use when processing input text for + * speech synthesis. Using a voice that is not supported for the engine + * selected will result in an error.

*/ Engine?: Engine; @@ -1229,7 +1232,8 @@ export interface StartSpeechSynthesisTaskInput { *

The audio frequency specified in Hz.

*

The valid values for mp3 and ogg_vorbis are "8000", "16000", "22050", * and "24000". The default value for standard voices is "22050". The default - * value for neural voices is "24000".

+ * value for neural voices is "24000". The default value for long-form voices + * is "24000".

*

Valid values for pcm are "8000" and "16000" The default value is * "16000".

*/ @@ -1313,10 +1317,10 @@ export class TextLengthExceededException extends __BaseException { export interface SynthesizeSpeechInput { /** * @public - *

Specifies the engine (standard or neural) - * for Amazon Polly to use when processing input text for speech synthesis. For - * information on Amazon Polly voices and which voices are available in - * standard-only, NTTS-only, and both standard and NTTS formats, see Available Voices.

+ *

Specifies the engine (standard, neural or + * long-form) for Amazon Polly to use when processing input text for + * speech synthesis. For information on Amazon Polly voices and which voices are + * available for each engine, see Available Voices.

*

* NTTS-only voices *

@@ -1324,8 +1328,16 @@ export interface SynthesizeSpeechInput { * required and must be set to neural. If the engine is not * specified, or is set to standard, this will result in an * error.

+ *

+ * long-form-only voices + *

+ *

When using long-form-only voices such as Danielle (en-US), this + * parameter is required and must be set to long-form. If the + * engine is not specified, or is set to standard or + * neural, this will result in an error.

*

Type: String

- *

Valid Values: standard | neural + *

Valid Values: standard | neural | + * long-form *

*

Required: Yes

*

@@ -1375,7 +1387,8 @@ export interface SynthesizeSpeechInput { *

The audio frequency specified in Hz.

*

The valid values for mp3 and ogg_vorbis are "8000", "16000", "22050", * and "24000". The default value for standard voices is "22050". The default - * value for neural voices is "24000".

+ * value for neural voices is "24000". The default value for long-form voices + * is "24000".

*

Valid values for pcm are "8000" and "16000" The default value is * "16000".

*/ diff --git a/codegen/sdk-codegen/aws-models/polly.json b/codegen/sdk-codegen/aws-models/polly.json index cd638f1901ad..5b544913f5ab 100644 --- a/codegen/sdk-codegen/aws-models/polly.json +++ b/codegen/sdk-codegen/aws-models/polly.json @@ -167,7 +167,7 @@ "Engine": { "target": "com.amazonaws.polly#Engine", "traits": { - "smithy.api#documentation": "

Specifies the engine (standard or neural)\n used by Amazon Polly when processing input text for speech synthesis.

", + "smithy.api#documentation": "

Specifies the engine (standard, neural or\n long-form) used by Amazon Polly when processing input text for\n speech synthesis.

", "smithy.api#httpQuery": "Engine" } }, @@ -232,6 +232,12 @@ "traits": { "smithy.api#enumValue": "neural" } + }, + "LONG_FORM": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "long-form" + } } } }, @@ -2400,7 +2406,7 @@ "Engine": { "target": "com.amazonaws.polly#Engine", "traits": { - "smithy.api#documentation": "

Specifies the engine (standard or neural)\n for Amazon Polly to use when processing input text for speech synthesis. Using a\n voice that is not supported for the engine selected will result in an\n error.

" + "smithy.api#documentation": "

Specifies the engine (standard, neural or\n long-form) for Amazon Polly to use when processing input text for\n speech synthesis. Using a voice that is not supported for the engine\n selected will result in an error.

" } }, "LanguageCode": { @@ -2438,7 +2444,7 @@ "SampleRate": { "target": "com.amazonaws.polly#SampleRate", "traits": { - "smithy.api#documentation": "

The audio frequency specified in Hz.

\n

The valid values for mp3 and ogg_vorbis are \"8000\", \"16000\", \"22050\",\n and \"24000\". The default value for standard voices is \"22050\". The default\n value for neural voices is \"24000\".

\n

Valid values for pcm are \"8000\" and \"16000\" The default value is\n \"16000\".

" + "smithy.api#documentation": "

The audio frequency specified in Hz.

\n

The valid values for mp3 and ogg_vorbis are \"8000\", \"16000\", \"22050\",\n and \"24000\". The default value for standard voices is \"22050\". The default\n value for neural voices is \"24000\". The default value for long-form voices\n is \"24000\".

\n

Valid values for pcm are \"8000\" and \"16000\" The default value is\n \"16000\".

" } }, "SnsTopicArn": { @@ -2498,7 +2504,7 @@ "Engine": { "target": "com.amazonaws.polly#Engine", "traits": { - "smithy.api#documentation": "

Specifies the engine (standard or neural)\n for Amazon Polly to use when processing input text for speech synthesis. Using a\n voice that is not supported for the engine selected will result in an\n error.

" + "smithy.api#documentation": "

Specifies the engine (standard, neural or\n long-form) for Amazon Polly to use when processing input text for\n speech synthesis. Using a voice that is not supported for the engine\n selected will result in an error.

" } }, "TaskId": { @@ -2559,7 +2565,7 @@ "SampleRate": { "target": "com.amazonaws.polly#SampleRate", "traits": { - "smithy.api#documentation": "

The audio frequency specified in Hz.

\n

The valid values for mp3 and ogg_vorbis are \"8000\", \"16000\", \"22050\",\n and \"24000\". The default value for standard voices is \"22050\". The default\n value for neural voices is \"24000\".

\n

Valid values for pcm are \"8000\" and \"16000\" The default value is\n \"16000\".

" + "smithy.api#documentation": "

The audio frequency specified in Hz.

\n

The valid values for mp3 and ogg_vorbis are \"8000\", \"16000\", \"22050\",\n and \"24000\". The default value for standard voices is \"22050\". The default\n value for neural voices is \"24000\". The default value for long-form voices\n is \"24000\".

\n

Valid values for pcm are \"8000\" and \"16000\" The default value is\n \"16000\".

" } }, "SpeechMarkTypes": { @@ -2681,7 +2687,7 @@ "Engine": { "target": "com.amazonaws.polly#Engine", "traits": { - "smithy.api#documentation": "

Specifies the engine (standard or neural)\n for Amazon Polly to use when processing input text for speech synthesis. For\n information on Amazon Polly voices and which voices are available in\n standard-only, NTTS-only, and both standard and NTTS formats, see Available Voices.

\n

\n NTTS-only voices\n

\n

When using NTTS-only voices such as Kevin (en-US), this parameter is\n required and must be set to neural. If the engine is not\n specified, or is set to standard, this will result in an\n error.

\n

Type: String

\n

Valid Values: standard | neural\n

\n

Required: Yes

\n

\n Standard voices\n

\n

For standard voices, this is not required; the engine parameter\n defaults to standard. If the engine is not specified, or is\n set to standard and an NTTS-only voice is selected, this will\n result in an error.

" + "smithy.api#documentation": "

Specifies the engine (standard, neural or\n long-form) for Amazon Polly to use when processing input text for\n speech synthesis. For information on Amazon Polly voices and which voices are\n available for each engine, see Available Voices.

\n

\n NTTS-only voices\n

\n

When using NTTS-only voices such as Kevin (en-US), this parameter is\n required and must be set to neural. If the engine is not\n specified, or is set to standard, this will result in an\n error.

\n

\n long-form-only voices\n

\n

When using long-form-only voices such as Danielle (en-US), this\n parameter is required and must be set to long-form. If the\n engine is not specified, or is set to standard or\n neural, this will result in an error.

\n

Type: String

\n

Valid Values: standard | neural |\n long-form\n

\n

Required: Yes

\n

\n Standard voices\n

\n

For standard voices, this is not required; the engine parameter\n defaults to standard. If the engine is not specified, or is\n set to standard and an NTTS-only voice is selected, this will\n result in an error.

" } }, "LanguageCode": { @@ -2706,7 +2712,7 @@ "SampleRate": { "target": "com.amazonaws.polly#SampleRate", "traits": { - "smithy.api#documentation": "

The audio frequency specified in Hz.

\n

The valid values for mp3 and ogg_vorbis are \"8000\", \"16000\", \"22050\",\n and \"24000\". The default value for standard voices is \"22050\". The default\n value for neural voices is \"24000\".

\n

Valid values for pcm are \"8000\" and \"16000\" The default value is\n \"16000\".

" + "smithy.api#documentation": "

The audio frequency specified in Hz.

\n

The valid values for mp3 and ogg_vorbis are \"8000\", \"16000\", \"22050\",\n and \"24000\". The default value for standard voices is \"22050\". The default\n value for neural voices is \"24000\". The default value for long-form voices\n is \"24000\".

\n

Valid values for pcm are \"8000\" and \"16000\" The default value is\n \"16000\".

" } }, "SpeechMarkTypes": { @@ -2910,7 +2916,7 @@ "SupportedEngines": { "target": "com.amazonaws.polly#EngineList", "traits": { - "smithy.api#documentation": "

Specifies which engines (standard or neural)\n that are supported by a given voice.

" + "smithy.api#documentation": "

Specifies which engines (standard, neural or\n long-form) are supported by a given voice.

" } } },