# Ejemplos de Amazon Polly que utilizan la AWS CLI
<a name="cli_polly_code_examples"></a>

En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con Amazon Polly.

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

**Topics**
+ [Acciones](#actions)

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

### `delete-lexicon`
<a name="polly_DeleteLexicon_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-lexicon`.

**AWS CLI**  
**Eliminación de un lexicón**  
En el siguiente ejemplo de `delete-lexicon` se elimina el lexicón especificado.  

```
aws polly delete-lexicon \
    --name w3c
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Uso de la operación DeleteLexicon](https://docs.aws.amazon.com/polly/latest/dg/gs-delete-lexicon.html) en la *Guía para desarrolladores de Amazon Polly*.  
+  Para obtener información sobre la API, consulte [DeleteLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/delete-lexicon.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-lexicon`
<a name="polly_GetLexicon_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-lexicon`.

**AWS CLI**  
**Recuperación del contenido de un léxico**  
En el siguiente ejemplo de `get-lexicon` se recupera el contenido del lexicón de pronunciación especificado.  

```
aws polly get-lexicon \
    --name w3c
```
Salida:  

```
{
    "Lexicon": {
        "Content": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<lexicon version=\"1.0\" \n      xmlns=    \"http://www.w3.org/2005/01/pronunciation-lexicon\"\n      xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n          xsi:schemaLocation=\"http://www.w3.org/2005/01/pronunciation-lexicon \n        http://www.w3.org/TR/2007/CR-pronunciation-    lexicon-20071212/pls.xsd\"\n      alphabet=\"ipa\" \n      xml:lang=\"en-US\">\n  <lexeme>\n    <grapheme>W3C</grapheme>\n        <alias>World Wide Web Consortium</alias>\n  </lexeme>\n</lexicon>\n",
        "Name": "w3c"
    },
    "LexiconAttributes": {
        "Alphabet": "ipa",
        "LanguageCode": "en-US",
        "LastModified": 1603908910.99,
        "LexiconArn": "arn:aws:polly:us-west-2:880185128111:lexicon/w3c",
        "LexemesCount": 1,
        "Size": 492
    }
}
```
Para obtener más información, consulte [Uso de la operación GetLexicon](https://docs.aws.amazon.com/polly/latest/dg/gs-get-lexicon.html) en la *Guía para desarrolladores de Amazon Polly*.  
+  Para obtener información sobre la API, consulte [GetLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-lexicon.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-speech-synthesis-task`
<a name="polly_GetSpeechSynthesisTask_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-speech-synthesis-task`.

**AWS CLI**  
**Obtención de información sobre una tarea de síntesis de voz**  
En el siguiente ejemplo de `get-speech-synthesis-task` se recupera información sobre la tarea de síntesis de voz especificada.  

```
aws polly get-speech-synthesis-task \
    --task-id 70b61c0f-57ce-4715-a247-cae8729dcce9
```
Salida:  

```
{
    "SynthesisTask": {
        "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
        "TaskStatus": "completed",
        "OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
        "CreationTime": 1603911042.689,
        "RequestCharacters": 1311,
        "OutputFormat": "mp3",
        "TextType": "text",
        "VoiceId": "Joanna"
    }
}
```
Para obtener más información, consulte [Creación de archivos de audio largos](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) en la *Guía para desarrolladores de Amazon Polly*.  
+  Para obtener información sobre la API, consulte [GetSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-speech-synthesis-task.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-lexicons`
<a name="polly_ListLexicons_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-lexicons`.

**AWS CLI**  
**Creación de una lista de léxicos**  
En el siguiente ejemplo de `list-lexicons` se enumeran sus léxicos de pronunciación.  

```
aws polly list-lexicons
```
Salida:  

```
{
    "Lexicons": [
        {
            "Name": "w3c",
            "Attributes": {
                "Alphabet": "ipa",
                "LanguageCode": "en-US",
                "LastModified": 1603908910.99,
                "LexiconArn": "arn:aws:polly:us-east-2:123456789012:lexicon/w3c",
                "LexemesCount": 1,
                "Size": 492
            }
        }
    ]
}
```
Para obtener más información, consulte [Uso de la operación ListLexicons](https://docs.aws.amazon.com/polly/latest/dg/gs-list-lexicons.html) en la *Guía para desarrolladores de Amazon Polly*.  
+  Para obtener información sobre la API, consulte [ListLexicons](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-lexicons.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-speech-synthesis-tasks`
<a name="polly_ListSpeechSynthesisTasks_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-speech-synthesis-tasks`.

**AWS CLI**  
**Para enumerar sus tareas de síntesis de voz**  
En el siguiente ejemplo de `list-speech-synthesis-tasks`, se enumeran las tareas de síntesis de voz.  

```
aws polly list-speech-synthesis-tasks
```
Salida:  

```
{
    "SynthesisTasks": [
        {
            "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
            "TaskStatus": "completed",
            "OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
            "CreationTime": 1603911042.689,
            "RequestCharacters": 1311,
            "OutputFormat": "mp3",
            "TextType": "text",
            "VoiceId": "Joanna"
        }
    ]
}
```
Para obtener más información, consulte [Creación de archivos de audio largos](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) en la *Guía para desarrolladores de Amazon Polly*.  
+  Para obtener información sobre la API, consulte [ListSpeechSynthesisTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-speech-synthesis-tasks.html) en la *Referencia de comandos de la AWS CLI*. 

### `put-lexicon`
<a name="polly_PutLexicon_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `put-lexicon`.

**AWS CLI**  
**Almacenamiento de un léxico**  
En el siguiente ejemplo de `put-lexicon` se almacena el léxico de pronunciación especificado. El archivo `example.pls` especifica un léxico compatible con PLS de W3C.  

```
aws polly put-lexicon \
    --name w3c \
    --content file://example.pls
```
Contenido de `example.pls`  

```
{
    <?xml version="1.0" encoding="UTF-8"?>
    <lexicon version="1.0"
        xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon
            http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
        alphabet="ipa"
        xml:lang="en-US">
        <lexeme>
            <grapheme>W3C</grapheme>
            <alias>World Wide Web Consortium</alias>
        </lexeme>
    </lexicon>
}
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Uso de la operación PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/gs-put-lexicon.html) en la *Guía para desarrolladores de Amazon Polly*.  
+  Para obtener información sobre la API, consulte [PutLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/put-lexicon.html) en la *Referencia de comandos de la AWS CLI*. 

### `start-speech-synthesis-task`
<a name="polly_StartSpeechSynthesisTask_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `start-speech-synthesis-task`.

**AWS CLI**  
**Sintetización de texto**  
En el siguiente ejemplo de `start-speech-synthesis-task` se sintetiza el texto en `text_file.txt` y almacena el archivo MP3 resultante en el bucket especificado.  

```
aws polly start-speech-synthesis-task \
    --output-format mp3 \
    --output-s3-bucket-name amzn-s3-demo-bucket \
    --text  file://text_file.txt \
    --voice-id Joanna
```
Salida:  

```
{
    "SynthesisTask": {
        "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
        "TaskStatus": "scheduled",
        "OutputUri": "https://s3.us-east-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
        "CreationTime": 1603911042.689,
        "RequestCharacters": 1311,
        "OutputFormat": "mp3",
        "TextType": "text",
        "VoiceId": "Joanna"
    }
}
```
Para obtener más información, consulte [Creación de archivos de audio largos](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) en la *Guía para desarrolladores de Amazon Polly*.  
+  Para obtener información sobre la API, consulte [StartSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/start-speech-synthesis-task.html) en la *Referencia de comandos de la AWS CLI*.