Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Acciones
<a name="API_Operations"></a>

Se admiten las siguientes acciones:
+  [DeleteLexicon](API_DeleteLexicon.md) 
+  [DescribeVoices](API_DescribeVoices.md) 
+  [GetLexicon](API_GetLexicon.md) 
+  [GetSpeechSynthesisTask](API_GetSpeechSynthesisTask.md) 
+  [ListLexicons](API_ListLexicons.md) 
+  [ListSpeechSynthesisTasks](API_ListSpeechSynthesisTasks.md) 
+  [PutLexicon](API_PutLexicon.md) 
+  [StartSpeechSynthesisStream](API_StartSpeechSynthesisStream.md) 
+  [StartSpeechSynthesisTask](API_StartSpeechSynthesisTask.md) 
+  [SynthesizeSpeech](API_SynthesizeSpeech.md) 

# DeleteLexicon
<a name="API_DeleteLexicon"></a>

Elimina el lexicón de pronunciación especificado y almacenado en una región de Región de AWS. Un léxico que se ha eliminado no está disponible para la síntesis de voz, ni es posible recuperarlo mediante la tecla `GetLexicon` o `ListLexicon` APIs.

Para obtener más información, consulte [Administración de lexicones](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

## Sintaxis de la solicitud
<a name="API_DeleteLexicon_RequestSyntax"></a>

```
DELETE /v1/lexicons/LexiconName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DeleteLexicon_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [LexiconName](#API_DeleteLexicon_RequestSyntax) **   <a name="polly-DeleteLexicon-request-uri-Name"></a>
El nombre del lexicón que se va a eliminar. Debe ser un lexicón existente en la región.  
Patrón: `[0-9A-Za-z]{1,20}`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_DeleteLexicon_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DeleteLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_DeleteLexicon_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteLexicon_Errors"></a>

 ** LexiconNotFoundException **   
Amazon Polly no encuentra el lexicón especificado. Esto puede deberse a la falta de un lexicón, a que su nombre esté mal escrito o a que se especifique un lexicón que se encuentra en una región diferente.  
Compruebe que el lexicón existe, se encuentra en la región (consulte [ListLexicons](API_ListLexicons.md)) y que ha escrito su nombre correctamente. Inténtelo de nuevo.  
Código de estado HTTP: 404

 ** ServiceFailureException **   
Una condición desconocida ha provocado un fallo en el servicio.  
Código de estado HTTP: 500

## Véase también
<a name="API_DeleteLexicon_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DeleteLexicon) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DeleteLexicon) 

# DescribeVoices
<a name="API_DescribeVoices"></a>

Devuelve la lista de voces que están disponibles para su uso cuando se solicita la síntesis de voz. Cada voz habla un idioma específico, es masculina o femenina, y se identifica mediante un identificador, que es la versión ASCII del nombre de la voz. 

Al sintetizar la locución (`SynthesizeSpeech`), debe proporcionar el identificador de voz de la voz que desee de la lista de voces devueltas por `DescribeVoices`.

Por ejemplo, quiere que su aplicación lectora de noticias lea las noticias en un idioma específico, pero que dé al usuario la opción de elegir la voz. Con la operación `DescribeVoices`, puede proporcionar al usuario una lista de las voces disponibles entre las que elegir.

 También puede especificar un código de idioma para filtrar las voces disponibles. Por ejemplo, si especifica `en-US`, la operación devuelve una lista de todas las voces disponibles para el idioma inglés de EE. UU. 

Esto operación requiere permisos para realizar la acción `polly:DescribeVoices`.

## Sintaxis de la solicitud
<a name="API_DescribeVoices_RequestSyntax"></a>

```
GET /v1/voices?Engine=Engine&IncludeAdditionalLanguageCodes=IncludeAdditionalLanguageCodes&LanguageCode=LanguageCode&NextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_DescribeVoices_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [Engine](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-Engine"></a>
Especifica el motor (`standard`, `neural`, `long-form` o `generative`) que utiliza Amazon Polly al procesar el texto de entrada para la síntesis de voz.   
Valores válidos: `standard | neural | long-form | generative` 

 ** [IncludeAdditionalLanguageCodes](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-IncludeAdditionalLanguageCodes"></a>
Valor booleano que indica si se deben devolver voces bilingües que utilicen el idioma especificado como idioma adicional. Por ejemplo, si solicita todos los idiomas que utilizan el inglés estadounidense (en-US) y hay una voz italiana que habla tanto italiano (it-IT) como inglés estadounidense, esa voz se incluirá si especifica `yes`, pero no si especifica `no`.

 ** [LanguageCode](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-LanguageCode"></a>
 La etiqueta de identificación del idioma (código ISO 639 para el nombre del idioma y código de país ISO 3166) para filtrar la lista de voces devueltas. Si no especifica este parámetro opcional, se devolverán todas las voces disponibles.   
Valores válidos: `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 | cs-CZ | de-CH | en-SG` 

 ** [NextToken](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-NextToken"></a>
Un token de paginación opaco devuelto por la operación `DescribeVoices` anterior. Si está presente, indica dónde continuar con el anuncio.  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4 096 caracteres.

## Cuerpo de la solicitud
<a name="API_DescribeVoices_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_DescribeVoices_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Voices": [ 
      { 
         "AdditionalLanguageCodes": [ "string" ],
         "Gender": "string",
         "Id": "string",
         "LanguageCode": "string",
         "LanguageName": "string",
         "Name": "string",
         "SupportedEngines": [ "string" ]
      }
   ]
}
```

## Elementos de respuesta
<a name="API_DescribeVoices_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-NextToken"></a>
El token de paginación que se utilizará en la próxima solicitud para continuar con la lista de voces. Se devuelve `NextToken` solo si la respuesta está truncada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4 096 caracteres.

 ** [Voices](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-Voices"></a>
Una lista de voces con sus propiedades.  
Tipo: matriz de objetos [Voice](API_Voice.md)

## Errores
<a name="API_DescribeVoices_Errors"></a>

 ** InvalidNextTokenException **   
El no NextToken es válido. Asegúrese de que esté bien escrito y, a continuación, vuelva a intentarlo.  
Código de estado HTTP: 400

 ** ServiceFailureException **   
Una condición desconocida ha provocado un fallo en el servicio.  
Código de estado HTTP: 500

## Véase también
<a name="API_DescribeVoices_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices) 

# GetLexicon
<a name="API_GetLexicon"></a>

Devuelve el contenido del lexicón de pronunciación especificado y almacenado en una Región de AWS. Para obtener más información, consulte [Administración de lexicones](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

## Sintaxis de la solicitud
<a name="API_GetLexicon_RequestSyntax"></a>

```
GET /v1/lexicons/LexiconName HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetLexicon_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [LexiconName](#API_GetLexicon_RequestSyntax) **   <a name="polly-GetLexicon-request-uri-Name"></a>
El nombre del lexicón.  
Patrón: `[0-9A-Za-z]{1,20}`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetLexicon_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Lexicon": { 
      "Content": "string",
      "Name": "string"
   },
   "LexiconAttributes": { 
      "Alphabet": "string",
      "LanguageCode": "string",
      "LastModified": number,
      "LexemesCount": number,
      "LexiconArn": "string",
      "Size": number
   }
}
```

## Elementos de respuesta
<a name="API_GetLexicon_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [Lexicon](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-Lexicon"></a>
Objeto de lexicón que proporciona el nombre y el contenido de la cadena del lexicón.   
Tipo: objeto [Lexicon](API_Lexicon.md)

 ** [LexiconAttributes](#API_GetLexicon_ResponseSyntax) **   <a name="polly-GetLexicon-response-LexiconAttributes"></a>
Metadatos del lexicón, incluido el alfabeto fonético utilizado, el código de idioma, el ARN del lexicón, el número de lexemas definidos en el lexicón y el tamaño del lexicón en bytes.  
Tipo: objeto [LexiconAttributes](API_LexiconAttributes.md)

## Errores
<a name="API_GetLexicon_Errors"></a>

 ** LexiconNotFoundException **   
Amazon Polly no encuentra el lexicón especificado. Esto puede deberse a la falta de un lexicón, a que su nombre esté mal escrito o a que se especifique un lexicón que se encuentra en una región diferente.  
Compruebe que el lexicón existe, se encuentra en la región (consulte [ListLexicons](API_ListLexicons.md)) y que ha escrito su nombre correctamente. Inténtelo de nuevo.  
Código de estado HTTP: 404

 ** ServiceFailureException **   
Una condición desconocida ha provocado un fallo en el servicio.  
Código de estado HTTP: 500

## Véase también
<a name="API_GetLexicon_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetLexicon) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetLexicon) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetLexicon) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetLexicon) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetLexicon) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetLexicon) 

# GetSpeechSynthesisTask
<a name="API_GetSpeechSynthesisTask"></a>

Recupera un SpeechSynthesisTask objeto específico en función de su identificador de tarea. Este objeto contiene información sobre la tarea de síntesis de voz determinada, incluido el estado de la tarea, y un enlace al bucket de S3 que contiene el resultado de la tarea.

## Sintaxis de la solicitud
<a name="API_GetSpeechSynthesisTask_RequestSyntax"></a>

```
GET /v1/synthesisTasks/TaskId HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_GetSpeechSynthesisTask_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [TaskId](#API_GetSpeechSynthesisTask_RequestSyntax) **   <a name="polly-GetSpeechSynthesisTask-request-uri-TaskId"></a>
El identificador generado por Amazon Polly para una tarea de síntesis de voz.  
Patrón: `^[a-zA-Z0-9_-]{1,100}$`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_GetSpeechSynthesisTask_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetSpeechSynthesisTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

## Elementos de respuesta
<a name="API_GetSpeechSynthesisTask_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [SynthesisTask](#API_GetSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-GetSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask objeto que proporciona información de la tarea solicitada, incluido el formato de salida, la hora de creación, el estado de la tarea, etc.  
Tipo: objeto [SynthesisTask](API_SynthesisTask.md)

## Errores
<a name="API_GetSpeechSynthesisTask_Errors"></a>

 ** InvalidTaskIdException **   
El identificador de tarea proporcionado no es válido. Proporcione un identificador de tarea válido e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** ServiceFailureException **   
Una condición desconocida ha provocado un fallo en el servicio.  
Código de estado HTTP: 500

 ** SynthesisTaskNotFoundException **   
No se encuentra la tarea de síntesis de voz con el identificador de tarea solicitado.  
Código de estado HTTP: 400

## Véase también
<a name="API_GetSpeechSynthesisTask_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/GetSpeechSynthesisTask) 

# ListLexicons
<a name="API_ListLexicons"></a>

Devuelve una lista de lexicones de pronunciación almacenados en una región de Región de AWS. Para obtener más información, consulte [Administración de lexicones](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

## Sintaxis de la solicitud
<a name="API_ListLexicons_RequestSyntax"></a>

```
GET /v1/lexicons?NextToken=NextToken HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListLexicons_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [NextToken](#API_ListLexicons_RequestSyntax) **   <a name="polly-ListLexicons-request-uri-NextToken"></a>
Un token de paginación opaco devuelto por una operación `ListLexicons` anterior. Si está presente, indica dónde continuar con la lista de lexicones.  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4 096 caracteres.

## Cuerpo de la solicitud
<a name="API_ListLexicons_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListLexicons_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Lexicons": [ 
      { 
         "Attributes": { 
            "Alphabet": "string",
            "LanguageCode": "string",
            "LastModified": number,
            "LexemesCount": number,
            "LexiconArn": "string",
            "Size": number
         },
         "Name": "string"
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListLexicons_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [Lexicons](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-Lexicons"></a>
Una lista de nombres y atributos de los lexicones.  
Tipo: matriz de objetos [LexiconDescription](API_LexiconDescription.md)

 ** [NextToken](#API_ListLexicons_ResponseSyntax) **   <a name="polly-ListLexicons-response-NextToken"></a>
El token de paginación que se utilizará en la próxima solicitud para continuar con la lista de lexicones. `NextToken` se devuelve solo si la respuesta está truncada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4 096 caracteres.

## Errores
<a name="API_ListLexicons_Errors"></a>

 ** InvalidNextTokenException **   
El no NextToken es válido. Asegúrese de que esté bien escrito y, a continuación, vuelva a intentarlo.  
Código de estado HTTP: 400

 ** ServiceFailureException **   
Una condición desconocida ha provocado un fallo en el servicio.  
Código de estado HTTP: 500

## Véase también
<a name="API_ListLexicons_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListLexicons) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListLexicons) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListLexicons) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListLexicons) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListLexicons) 

# ListSpeechSynthesisTasks
<a name="API_ListSpeechSynthesisTasks"></a>

Devuelve una lista de SpeechSynthesisTask objetos ordenados por su fecha de creación. Esta operación puede filtrar las tareas por su estado, por ejemplo, lo que permite a los usuarios enumerar solo las tareas que se han completado.

## Sintaxis de la solicitud
<a name="API_ListSpeechSynthesisTasks_RequestSyntax"></a>

```
GET /v1/synthesisTasks?MaxResults=MaxResults&NextToken=NextToken&Status=Status HTTP/1.1
```

## Parámetros de solicitud del URI
<a name="API_ListSpeechSynthesisTasks_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [MaxResults](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-MaxResults"></a>
Número máximo de tareas de síntesis de voz devueltas en una operación de lista.  
Rango válido: valor mínimo de 1. Valor máximo de 100.

 ** [NextToken](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-NextToken"></a>
El token de paginación que se utilizará en la siguiente solicitud para continuar con la lista de tareas de síntesis de voz.   
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4 096 caracteres.

 ** [Status](#API_ListSpeechSynthesisTasks_RequestSyntax) **   <a name="polly-ListSpeechSynthesisTasks-request-uri-Status"></a>
Estado de las tareas de síntesis de voz devueltas en una operación de lista  
Valores válidos: `scheduled | inProgress | completed | failed` 

## Cuerpo de la solicitud
<a name="API_ListSpeechSynthesisTasks_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_ListSpeechSynthesisTasks_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SynthesisTasks": [ 
      { 
         "CreationTime": number,
         "Engine": "string",
         "LanguageCode": "string",
         "LexiconNames": [ "string" ],
         "OutputFormat": "string",
         "OutputUri": "string",
         "RequestCharacters": number,
         "SampleRate": "string",
         "SnsTopicArn": "string",
         "SpeechMarkTypes": [ "string" ],
         "TaskId": "string",
         "TaskStatus": "string",
         "TaskStatusReason": "string",
         "TextType": "string",
         "VoiceId": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListSpeechSynthesisTasks_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-NextToken"></a>
Un token de paginación opaco devuelto por la operación de lista anterior de esta solicitud. Si está presente, indica dónde continuar con el anuncio.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 4 096 caracteres.

 ** [SynthesisTasks](#API_ListSpeechSynthesisTasks_ResponseSyntax) **   <a name="polly-ListSpeechSynthesisTasks-response-SynthesisTasks"></a>
Lista de SynthesisTask objetos que proporciona información de la tarea especificada en la solicitud de lista, incluidos el formato de salida, la hora de creación, el estado de la tarea, etc.  
Tipo: matriz de objetos [SynthesisTask](API_SynthesisTask.md)

## Errores
<a name="API_ListSpeechSynthesisTasks_Errors"></a>

 ** InvalidNextTokenException **   
El no NextToken es válido. Asegúrese de que esté bien escrito y, a continuación, vuelva a intentarlo.  
Código de estado HTTP: 400

 ** ServiceFailureException **   
Una condición desconocida ha provocado un fallo en el servicio.  
Código de estado HTTP: 500

## Véase también
<a name="API_ListSpeechSynthesisTasks_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListSpeechSynthesisTasks) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListSpeechSynthesisTasks) 

# PutLexicon
<a name="API_PutLexicon"></a>

Almacena un lexicón de pronunciación en una Región de AWS. Si ya existe un lexicón con el mismo nombre en la región, el nuevo léxico lo sobrescribe. Las operaciones del léxico tienen una consistencia eventual, por lo que puede pasar algún tiempo antes de que el léxico esté disponible para la SynthesizeSpeech operación.

Para obtener más información, consulte [Administración de lexicones](https://docs.aws.amazon.com/polly/latest/dg/managing-lexicons.html).

## Sintaxis de la solicitud
<a name="API_PutLexicon_RequestSyntax"></a>

```
PUT /v1/lexicons/LexiconName HTTP/1.1
Content-type: application/json

{
   "Content": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_PutLexicon_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [LexiconName](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-uri-Name"></a>
El nombre del lexicón. El nombre debe seguir el formato expreso normal [0-9A-Za-z] \$11,20\$1. Es decir, el nombre es una cadena alfanumérica que distingue mayúsculas de minúsculas y tiene una longitud máxima de 20 caracteres.   
Patrón: `[0-9A-Za-z]{1,20}`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_PutLexicon_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Content](#API_PutLexicon_RequestSyntax) **   <a name="polly-PutLexicon-request-Content"></a>
Contenido del lexicón PLS en forma de cadena de datos.  
Tipo: cadena  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_PutLexicon_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_PutLexicon_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_PutLexicon_Errors"></a>

 ** InvalidLexiconException **   
Amazon Polly no encuentra el lexicón especificado. Asegúrese de que el nombre del lexicón esté bien escrito y, a continuación, vuelva a intentarlo.  
Código de estado HTTP: 400

 ** LexiconSizeExceededException **   
Esta operación superaría el tamaño máximo del lexicón especificado.  
Código de estado HTTP: 400

 ** MaxLexemeLengthExceededException **   
Esta operación superaría el tamaño máximo del lexema.  
Código de estado HTTP: 400

 ** MaxLexiconsNumberExceededException **   
Esta operación superaría el número máximo de lexicones.  
Código de estado HTTP: 400

 ** ServiceFailureException **   
Una condición desconocida ha provocado un fallo en el servicio.  
Código de estado HTTP: 500

 ** UnsupportedPlsAlphabetException **   
El alfabeto especificado en el lexicón no es un alfabeto compatible. Los valores válidos son `x-sampa` y `ipa`.  
Código de estado HTTP: 400

 ** UnsupportedPlsLanguageException **   
El idioma especificado en el lexicón no es compatible. Para ver una lista de los idiomas compatibles, consulte [Atributos del lexicón](https://docs.aws.amazon.com/polly/latest/dg/API_LexiconAttributes.html).  
Código de estado HTTP: 400

## Véase también
<a name="API_PutLexicon_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/PutLexicon) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/PutLexicon) 

# StartSpeechSynthesisStream
<a name="API_StartSpeechSynthesisStream"></a>

Sintetiza entradas UTF-8, texto sin formato o SSML a través de una conexión de streaming bidireccional. Especifique los parámetros de síntesis en los encabezados HTTP/2, envíe texto de forma incremental como eventos en el flujo de entrada y reciba audio sintetizado a medida que esté disponible.

Esta operación sirve como contraparte bidireccional de: `SynthesizeSpeech`
+  [SynthesizeSpeech](https://docs.aws.amazon.com/polly/latest/dg/API_SynthesizeSpeech.html) 

## Sintaxis de la solicitud
<a name="API_StartSpeechSynthesisStream_RequestSyntax"></a>

```
POST /v1/synthesisStream HTTP/1.1
x-amzn-Engine: Engine
x-amzn-LanguageCode: LanguageCode
x-amzn-LexiconNames: LexiconNames
x-amzn-OutputFormat: OutputFormat
x-amzn-SampleRate: SampleRate
x-amzn-VoiceId: VoiceId
Content-type: application/json

{
   "CloseStreamEvent": { 
   },
   "TextEvent": { 
      "FlushStreamConfiguration": { 
         "Force": boolean
      },
      "Text": "string",
      "TextType": "string"
   }
}
```

## Parámetros de solicitud del URI
<a name="API_StartSpeechSynthesisStream_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [Engine](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-Engine"></a>
Especifica el motor que utilizará Amazon Polly al procesar el texto de entrada para la síntesis de voz. Actualmente, solo se admite el `generative` motor. Si especificas una voz que el motor seleccionado no admite, Amazon Polly devolverá un error.  
Valores válidos: `standard | neural | long-form | generative`   
Obligatorio: sí

 ** [LanguageCode](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LanguageCode"></a>
Parámetro opcional que establece el código de idioma de la solicitud de síntesis de voz. Especifique este parámetro solo cuando utilice una voz bilingüe. Si se utiliza una voz bilingüe y no se especifica ningún código de idioma, Amazon Polly utilizará el idioma predeterminado de la voz bilingüe.  
Valores válidos: `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 | cs-CZ | de-CH | en-SG` 

 ** [LexiconNames](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-LexiconNames"></a>
Los nombres de uno o más léxicos de pronunciación para que el servicio los aplique durante la síntesis. Amazon Polly aplica los léxicos solo cuando el idioma del léxico coincide con el idioma de la voz.  
Miembros de la matriz: número máximo de 5 elementos.  
Patrón: `[0-9A-Za-z]{1,20}` 

 ** [OutputFormat](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-OutputFormat"></a>
El formato de audio de la voz sintetizada. Actualmente, Amazon Polly no admite las marcas de voz JSON.  
Valores válidos: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obligatorio: sí

 ** [SampleRate](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-SampleRate"></a>
La frecuencia de audio, especificada en Hz.

 ** [VoiceId](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-VoiceId"></a>
La voz que se utilizará en la síntesis. Para obtener una lista de las voces disponibles IDs, utilice la [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operación.  
Valores válidos: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Obligatorio: sí

## Cuerpo de la solicitud
<a name="API_StartSpeechSynthesisStream_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [CloseStreamEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-CloseStreamEvent"></a>
Un evento que indica el final del flujo de entrada.  
Tipo: objeto [CloseStreamEvent](API_CloseStreamEvent.md)  
Obligatorio: no

 ** [TextEvent](#API_StartSpeechSynthesisStream_RequestSyntax) **   <a name="polly-StartSpeechSynthesisStream-request-TextEvent"></a>
Un evento de texto que contiene contenido que se va a sintetizar.  
Tipo: objeto [TextEvent](API_TextEvent.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_StartSpeechSynthesisStream_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AudioEvent": { 
      "AudioChunk": blob
   },
   "ServiceFailureException": { 
   },
   "ServiceQuotaExceededException": { 
   },
   "StreamClosedEvent": { 
      "RequestCharacters": number
   },
   "ThrottlingException": { 
   },
   "ValidationException": { 
   }
}
```

## Elementos de respuesta
<a name="API_StartSpeechSynthesisStream_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AudioEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-AudioEvent"></a>
Evento de audio que contiene voz sintetizada.  
Tipo: objeto [AudioEvent](API_AudioEvent.md)

 ** [ServiceFailureException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceFailureException"></a>
Una condición desconocida ha provocado un fallo en el servicio.  
Tipo: Excepción  
Código de estado HTTP: 500

 ** [ServiceQuotaExceededException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ServiceQuotaExceededException"></a>
Una excepción que indica que se superaría una cuota de servicio.  
Tipo: excepción  
Código de estado HTTP: 402

 ** [StreamClosedEvent](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-StreamClosedEvent"></a>
Un evento, con información resumida, que indica que la transmisión se ha cerrado.  
Tipo: objeto [StreamClosedEvent](API_StreamClosedEvent.md)

 ** [ThrottlingException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ThrottlingException"></a>
Una excepción que indica que la solicitud se ha limitado.  
Tipo: excepción  
Código de estado HTTP: 400

 ** [ValidationException](#API_StartSpeechSynthesisStream_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisStream-response-ValidationException"></a>
Una excepción que indica que la entrada no se validó correctamente.  
Tipo: excepción  
Código de estado HTTP: 400

## Errores
<a name="API_StartSpeechSynthesisStream_Errors"></a>

 ** ServiceFailureException **   
Una condición desconocida ha provocado un fallo en el servicio.  
Código de estado HTTP: 500

 ** ServiceQuotaExceededException **   
La solicitud provocaría que se superara una cuota de servicio.    
 ** quotaCode **   
El código de cuota que identifica la cuota específica.  
 ** serviceCode **   
El código de servicio que identifica el servicio de origen.
Código de estado HTTP: 402

 ** ThrottlingException **   
La solicitud se denegó debido a la limitación de las solicitudes.    
 ** throttlingReasons **   
Una lista de los motivos que explican por qué se ha limitado la solicitud.
Código de estado HTTP: 400

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica el servicio de .    
 ** fields **   
Los campos que provocaron el error de validación.  
 ** reason **   
El motivo por el que la solicitud no se validó.
Código de estado HTTP: 400

## Véase también
<a name="API_StartSpeechSynthesisStream_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisStream) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisStream) 

# StartSpeechSynthesisTask
<a name="API_StartSpeechSynthesisTask"></a>

Permite crear una tarea de síntesis asíncrona, iniciando una nueva `SpeechSynthesisTask`. Esta operación requiere toda la información estándar necesaria para la síntesis de voz, además del nombre de un bucket de Amazon S3 para que el servicio almacene el resultado de la tarea de síntesis y dos parámetros opcionales (`OutputS3KeyPrefix` y `SnsTopicArn`). Una vez creada la tarea de síntesis, esta operación devolverá un objeto `SpeechSynthesisTask`, que incluirá un identificador de la tarea y su estado actual. El objeto `SpeechSynthesisTask` estará disponible durante 72 horas después de iniciar la tarea de síntesis asíncrona.

## Sintaxis de la solicitud
<a name="API_StartSpeechSynthesisTask_RequestSyntax"></a>

```
POST /v1/synthesisTasks HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "OutputS3BucketName": "string",
   "OutputS3KeyPrefix": "string",
   "SampleRate": "string",
   "SnsTopicArn": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_StartSpeechSynthesisTask_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_StartSpeechSynthesisTask_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Engine](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Engine"></a>
Especifica el motor (`standard`, `neural`, `long-form` o `generative`) que utilizará Amazon Polly al procesar el texto de entrada para la síntesis de voz. El uso de una voz que no sea compatible con el motor seleccionado provocará un error.  
Tipo: cadena  
Valores válidos: `standard | neural | long-form | generative`   
Obligatorio: no

 ** [LanguageCode](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LanguageCode"></a>
Código de idioma opcional para la solicitud de síntesis de voz. Esto solo es necesario si se utiliza una voz bilingüe, como Aditi, que se puede utilizar tanto en inglés indio (en-IN) como en hindi (hi-IN).   
Si se utiliza una voz bilingüe y no se especifica ningún código de idioma, Amazon Polly utilizará el idioma predeterminado de la voz bilingüe. El idioma predeterminado de cualquier voz es el que devuelve la [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operación para el `LanguageCode` parámetro. Por ejemplo, si no se especifica ningún código de idioma, Aditi utilizará el inglés indio en lugar del hindi.  
Tipo: cadena  
Valores válidos: `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 | cs-CZ | de-CH | en-SG`   
Obligatorio: no

 ** [LexiconNames](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-LexiconNames"></a>
Enumere uno o más nombres de lexicones de pronunciación que desee que el servicio aplique durante la síntesis. Los lexicones solamente se aplican al texto si el idioma especificado en ellos es el mismo que el idioma elegido.   
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 5 elementos.  
Patrón: `[0-9A-Za-z]{1,20}`   
Obligatorio: no

 ** [OutputFormat](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputFormat"></a>
Formato en el que se codificará la salida devuelta. Para la transmisión de audio, será mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law o pcm. Para las marcas de voz, será json.   
Tipo: cadena  
Valores válidos: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obligatorio: sí

 ** [OutputS3BucketName](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3BucketName"></a>
Nombre del bucket de Amazon S3 en el que se guardará el archivo de salida.  
Tipo: cadena  
Patrón: `^[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]$`   
Obligatorio: sí

 ** [OutputS3KeyPrefix](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-OutputS3KeyPrefix"></a>
El prefijo de clave de Amazon S3 para el archivo de voz de salida.  
Tipo: cadena  
Patrón: `^[0-9a-zA-Z\/\!\-_\.\*\'\(\):;\$@=+\,\?&]{0,800}$`   
Obligatorio: no

 ** [SampleRate](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SampleRate"></a>
La frecuencia de audio especificada en Hz.  
Los valores válidos para mp3 y ogg\$1vorbis son “8000”, “16 000”, “22 050” y “24 000”. El valor predeterminado para las voces estándar es “22 050". El valor predeterminado para las voces neuronales es "24 000". El valor predeterminado para las voces de formato largo es “24 000”. El valor predeterminado para las voces generativas es "24 000".  
Los valores válidos para el pcm son "8000" y "16 000". El valor por defecto es "16 000".   
El valor válido para ogg\$1opus es «48000".   
El valor válido para mu-law y a-law es «8000".   
Tipo: cadena  
Requerido: no

 ** [SnsTopicArn](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SnsTopicArn"></a>
El ARN para el tema de SNS se usa opcionalmente para proporcionar una notificación de estado para una tarea de síntesis de voz.  
Tipo: cadena  
Patrón: `^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$`   
Obligatorio: no

 ** [SpeechMarkTypes](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-SpeechMarkTypes"></a>
El tipo de marcas de voz devueltas para el texto de entrada.  
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 4 elementos.  
Valores válidos: `sentence | ssml | viseme | word`   
Obligatorio: no

 ** [Text](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-Text"></a>
El texto de entrada que se va a sintetizar. Si especifica ssml como TextType, siga el formato SSML para el texto de entrada.   
Tipo: cadena  
Obligatorio: sí

 ** [TextType](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-TextType"></a>
Especifica si el texto de entrada es texto sin formato o SSML. El valor predeterminado es texto sin formato.   
Tipo: cadena  
Valores válidos: `ssml | text`   
Obligatorio: no

 ** [VoiceId](#API_StartSpeechSynthesisTask_RequestSyntax) **   <a name="polly-StartSpeechSynthesisTask-request-VoiceId"></a>
ID de voz que se usará para la síntesis.   
Tipo: cadena  
Valores válidos: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_StartSpeechSynthesisTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "SynthesisTask": { 
      "CreationTime": number,
      "Engine": "string",
      "LanguageCode": "string",
      "LexiconNames": [ "string" ],
      "OutputFormat": "string",
      "OutputUri": "string",
      "RequestCharacters": number,
      "SampleRate": "string",
      "SnsTopicArn": "string",
      "SpeechMarkTypes": [ "string" ],
      "TaskId": "string",
      "TaskStatus": "string",
      "TaskStatusReason": "string",
      "TextType": "string",
      "VoiceId": "string"
   }
}
```

## Elementos de respuesta
<a name="API_StartSpeechSynthesisTask_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [SynthesisTask](#API_StartSpeechSynthesisTask_ResponseSyntax) **   <a name="polly-StartSpeechSynthesisTask-response-SynthesisTask"></a>
SynthesisTask objeto que proporciona información y atributos sobre una tarea de síntesis de voz recién enviada.  
Tipo: objeto [SynthesisTask](API_SynthesisTask.md)

## Errores
<a name="API_StartSpeechSynthesisTask_Errors"></a>

 ** EngineNotSupportedException **   
Este motor no es compatible con la voz que ha designado. Elija una voz nueva que sea compatible con el motor o cámbielo y reinicie la operación.  
Código de estado HTTP: 400

 ** InvalidS3BucketException **   
El nombre de bucket de Amazon S3 proporcionado no es válido. Compruebe lo que ha introducido con los requisitos de denominación del bucket de S3 e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InvalidS3KeyException **   
El prefijo de clave de Amazon S3 no es válido. Proporcione un nombre de clave de objeto de S3 válido.  
Código de estado HTTP: 400

 ** InvalidSampleRateException **   
La frecuencia de muestreo especificada no es válida.  
Código de estado HTTP: 400

 ** InvalidSnsTopicArnException **   
El ARN del tema de SNS proporcionado no es válido. Introduzca un ARN de tema de SNS válido e inténtelo de nuevo.  
Código de estado HTTP: 400

 ** InvalidSsmlException **   
El SSML que ha proporcionado no es válido. Compruebe la sintaxis de SSML y la ortografía de las etiquetas y los valores y, a continuación, vuelva a intentarlo.  
Código de estado HTTP: 400

 ** LanguageNotSupportedException **   
Actualmente, el idioma especificado en esta capacidad no es compatible con Amazon Polly.  
Código de estado HTTP: 400

 ** LexiconNotFoundException **   
Amazon Polly no encuentra el lexicón especificado. Esto puede deberse a la falta de un lexicón, a que su nombre esté mal escrito o a que se especifique un lexicón que se encuentra en una región diferente.  
Compruebe que el lexicón existe, se encuentra en la región (consulte [ListLexicons](API_ListLexicons.md)) y que ha escrito su nombre correctamente. Inténtelo de nuevo.  
Código de estado HTTP: 404

 ** MarksNotSupportedForFormatException **   
Las marcas de voz no son compatibles con el `OutputFormat` seleccionado. Las marcas de voz solo están disponibles para el contenido en formato `json`.  
Código de estado HTTP: 400

 ** ServiceFailureException **   
Una condición desconocida ha provocado un fallo en el servicio.  
Código de estado HTTP: 500

 ** SsmlMarksNotSupportedForTextTypeException **   
Las marcas de voz SSML no son compatibles con la entrada de texto simple.  
Código de estado HTTP: 400

 ** TextLengthExceededException **   
El valor del parámetro "Text" supera los límites aceptados. Para la API `SynthesizeSpeech`, el límite de entrada de texto es de un máximo de 6000 caracteres en total, de los cuales no se pueden facturar más de 3000 caracteres. Para la API `StartSpeechSynthesisTask`, el máximo es de 200 000 caracteres, de los cuales no se pueden facturar más de 100 000 caracteres. Las etiquetas SSML no cuentan como caracteres contabilizados.  
Código de estado HTTP: 400

## Véase también
<a name="API_StartSpeechSynthesisTask_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/StartSpeechSynthesisTask) 

# SynthesizeSpeech
<a name="API_SynthesizeSpeech"></a>

Sintetiza la entrada UTF-8, texto sin formato o SSML, en una secuencia de bytes. La entrada SSML debe ser un SSML válido y bien formado. Es posible que algunos alfabetos no estén disponibles con todas las voces (por ejemplo, es posible que las voces en inglés no lean en absoluto el cirílico) a menos que se utilice el mapeo de fonemas. Para obtener más información, consulte [Cómo funciona](https://docs.aws.amazon.com/polly/latest/dg/how-text-to-speech-works.html).

## Sintaxis de la solicitud
<a name="API_SynthesizeSpeech_RequestSyntax"></a>

```
POST /v1/speech HTTP/1.1
Content-type: application/json

{
   "Engine": "string",
   "LanguageCode": "string",
   "LexiconNames": [ "string" ],
   "OutputFormat": "string",
   "SampleRate": "string",
   "SpeechMarkTypes": [ "string" ],
   "Text": "string",
   "TextType": "string",
   "VoiceId": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_SynthesizeSpeech_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_SynthesizeSpeech_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Engine](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Engine"></a>
Especifica el motor (`standard`, `neural`, `long-form` o `generative`) que utilizará Amazon Polly al procesar el texto de entrada para la síntesis de voz. Proporcione un motor compatible con la voz que seleccione. Si no proporciona un motor, se selecciona el motor estándar de forma predeterminada. Si una voz elegida no es compatible con el motor estándar, se producirá un error. Para obtener información sobre las voces de Amazon Polly y qué voces están disponibles para cada motor, consulte [Voces disponibles](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html).  
Tipo: cadena  
Valores válidos: `standard | neural | long-form | generative`   
Obligatorio: no

 ** [LanguageCode](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LanguageCode"></a>
Código de idioma opcional para la solicitud de sintetizar voz. Esto solo es necesario si se utiliza una voz bilingüe, como Aditi, que se puede utilizar tanto en inglés indio (en-IN) como en hindi (hi-IN).   
Si se utiliza una voz bilingüe y no se especifica ningún código de idioma, Amazon Polly utilizará el idioma predeterminado de la voz bilingüe. El idioma predeterminado de cualquier voz es el que devuelve la [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)operación para el `LanguageCode` parámetro. Por ejemplo, si no se especifica ningún código de idioma, Aditi utilizará el inglés indio en lugar del hindi.  
Tipo: cadena  
Valores válidos: `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 | cs-CZ | de-CH | en-SG`   
Obligatorio: no

 ** [LexiconNames](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-LexiconNames"></a>
Enumere uno o más nombres de lexicones de pronunciación que desee que el servicio aplique durante la síntesis. Los lexicones solamente se aplican al texto si el idioma especificado en ellos es el mismo que el idioma elegido. Para obtener información sobre el almacenamiento de léxicos, consulte [PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/API_PutLexicon.html).  
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 5 elementos.  
Patrón: `[0-9A-Za-z]{1,20}`   
Obligatorio: no

 ** [OutputFormat](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-OutputFormat"></a>
 Formato en el que se codificará la salida devuelta. Para la transmisión de audio, será mp3, ogg\$1vorbis, ogg\$1opus, mu-law, a-law o pcm. Para las marcas de voz, será json.   
Cuando se utiliza pcm, el contenido devuelto está audio/pcm en un formato little-endian firmado de 16 bits y 1 canal (mono).   
Tipo: cadena  
Valores válidos: `json | mp3 | ogg_opus | ogg_vorbis | pcm`   
Obligatorio: sí

 ** [SampleRate](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SampleRate"></a>
La frecuencia de audio especificada en Hz.  
Los valores válidos para mp3 y ogg\$1vorbis son “8000”, “16000”, “22050”, “24000”, “44100” y “48000”. El valor predeterminado para las voces estándar es “22 050". El valor predeterminado para las voces neuronales es "24 000". El valor predeterminado para las voces de formato largo es “24 000”. El valor predeterminado para las voces generativas es "24 000".  
Los valores válidos para el pcm son "8000" y "16 000". El valor por defecto es "16 000".   
El valor válido para ogg\$1opus es «48000".   
El valor válido para mu-law y a-law es «8000".   
Tipo: cadena  
Requerido: no

 ** [SpeechMarkTypes](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-SpeechMarkTypes"></a>
El tipo de marcas de voz devueltas para el texto de entrada.  
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 4 elementos.  
Valores válidos: `sentence | ssml | viseme | word`   
Obligatorio: no

 ** [Text](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-Text"></a>
 Introduzca el texto para sintetizarlo. Si especifica `ssml` como el `TextType`, siga el formato SSML para el texto de entrada.   
Tipo: cadena  
Obligatorio: sí

 ** [TextType](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-TextType"></a>
 Especifica si el texto de entrada es texto sin formato o SSML. El valor predeterminado es texto sin formato. Para obtener más información, consulte [Uso de SSML](https://docs.aws.amazon.com/polly/latest/dg/ssml.html).  
Tipo: cadena  
Valores válidos: `ssml | text`   
Obligatorio: no

 ** [VoiceId](#API_SynthesizeSpeech_RequestSyntax) **   <a name="polly-SynthesizeSpeech-request-VoiceId"></a>
 ID de voz que se usará para la síntesis. Puede obtener una lista de las voces IDs disponibles llamando a la operación. [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html)   
Tipo: cadena  
Valores válidos: `Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_SynthesizeSpeech_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: ContentType
x-amzn-RequestCharacters: RequestCharacters

AudioStream
```

## Elementos de respuesta
<a name="API_SynthesizeSpeech_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

La respuesta devuelve los siguientes encabezados HTTP.

 ** [ContentType](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-ContentType"></a>
 Especifica el tipo de transmisión de audio. Esto debería reflejar el `OutputFormat` del parámetro de su solicitud.   
+  Si solicita `mp3` como el `OutputFormat`, el `ContentType` resultante es audio/mpeg. 
+  Si solicita `ogg_vorbis` como el `OutputFormat`, el `ContentType` resultante es audio/ogg. 
+  Si solicita `ogg_opus` como el `OutputFormat`, el `ContentType` resultante es audio/ogg. 
+  Si lo solicita `pcm` como`OutputFormat`, lo `ContentType` devuelto está audio/pcm en un formato little-endian firmado de 16 bits y 1 canal (mono). 
+  Si lo solicitas `mu-law` como el`OutputFormat`, el resultado es audio/mulaw`ContentType`. 
+  Si lo solicita `a-law` como el`OutputFormat`, lo `ContentType` devuelto es audio/alaw. 
+ Si lo solicita `json` como el`OutputFormat`, lo `ContentType` devuelto es la aplicación/. x-json-stream
 

 ** [RequestCharacters](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-RequestCharacters"></a>
Número de caracteres sintetizados.

La respuesta devuelve lo siguiente como el cuerpo HTTP.

 ** [AudioStream](#API_SynthesizeSpeech_ResponseSyntax) **   <a name="polly-SynthesizeSpeech-response-AudioStream"></a>
 Secuencia que contiene la voz sintetizada. 

## Errores
<a name="API_SynthesizeSpeech_Errors"></a>

 ** EngineNotSupportedException **   
Este motor no es compatible con la voz que ha designado. Elija una voz nueva que sea compatible con el motor o cámbielo y reinicie la operación.  
Código de estado HTTP: 400

 ** InvalidSampleRateException **   
La frecuencia de muestreo especificada no es válida.  
Código de estado HTTP: 400

 ** InvalidSsmlException **   
El SSML que ha proporcionado no es válido. Compruebe la sintaxis de SSML y la ortografía de las etiquetas y los valores y, a continuación, vuelva a intentarlo.  
Código de estado HTTP: 400

 ** LanguageNotSupportedException **   
Actualmente, el idioma especificado en esta capacidad no es compatible con Amazon Polly.  
Código de estado HTTP: 400

 ** LexiconNotFoundException **   
Amazon Polly no encuentra el lexicón especificado. Esto puede deberse a la falta de un lexicón, a que su nombre esté mal escrito o a que se especifique un lexicón que se encuentra en una región diferente.  
Compruebe que el lexicón existe, se encuentra en la región (consulte [ListLexicons](API_ListLexicons.md)) y que ha escrito su nombre correctamente. Inténtelo de nuevo.  
Código de estado HTTP: 404

 ** MarksNotSupportedForFormatException **   
Las marcas de voz no son compatibles con el `OutputFormat` seleccionado. Las marcas de voz solo están disponibles para el contenido en formato `json`.  
Código de estado HTTP: 400

 ** ServiceFailureException **   
Una condición desconocida ha provocado un fallo en el servicio.  
Código de estado HTTP: 500

 ** SsmlMarksNotSupportedForTextTypeException **   
Las marcas de voz SSML no son compatibles con la entrada de texto simple.  
Código de estado HTTP: 400

 ** TextLengthExceededException **   
El valor del parámetro "Text" supera los límites aceptados. Para la API `SynthesizeSpeech`, el límite de entrada de texto es de un máximo de 6000 caracteres en total, de los cuales no se pueden facturar más de 3000 caracteres. Para la API `StartSpeechSynthesisTask`, el máximo es de 200 000 caracteres, de los cuales no se pueden facturar más de 100 000 caracteres. Las etiquetas SSML no cuentan como caracteres contabilizados.  
Código de estado HTTP: 400

## Véase también
<a name="API_SynthesizeSpeech_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech)