# Exemplos do Amazon Polly usando o AWS CLI
<a name="cli_polly_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Amazon Polly.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

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

O código de exemplo a seguir mostra como usar `delete-lexicon`.

**AWS CLI**  
**Como excluir um léxico**  
O exemplo de `delete-lexicon` a seguir exclui o léxico especificado.  

```
aws polly delete-lexicon \
    --name w3c
```
Este comando não produz saída.  
Para obter mais informações, consulte [Uso da operação DeleteLexicon](https://docs.aws.amazon.com/polly/latest/dg/gs-delete-lexicon.html) no *Guia do desenvolvedor do Amazon Polly*.  
+  Consulte detalhes da API em [DeleteLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/delete-lexicon.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `get-lexicon`.

**AWS CLI**  
**Para recuperar o conteúdo de um léxico**  
O exemplo de `get-lexicon` a seguir recupera o conteúdo do léxico de pronúncia especificado.  

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

```
{
    "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 obter mais informações, consulte [Usando a operação GetLexicon](https://docs.aws.amazon.com/polly/latest/dg/gs-get-lexicon.html) no *Guia do desenvolvedor do Amazon Polly*.  
+  Consulte detalhes da API em [GetLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-lexicon.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `get-speech-synthesis-task`.

**AWS CLI**  
**Como obter informações sobre uma tarefa de síntese de fala**  
O exemplo de `get-speech-synthesis-task` a seguir recupera informações sobre a tarefa de síntese de fala especificada.  

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

```
{
    "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 obter mais informações, consulte [Criar arquivos de áudio longos](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) no *Guia do desenvolvedor do Amazon Polly*.  
+  Consulte detalhes da API em [GetSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-speech-synthesis-task.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `list-lexicons`.

**AWS CLI**  
**Para listar os léxicos**  
O exemplo de `list-lexicons` a seguir lista os léxicos de pronúncia.  

```
aws polly list-lexicons
```
Resultado:  

```
{
    "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 obter mais informações, consulte [Uso das operações ListLexicons](https://docs.aws.amazon.com/polly/latest/dg/gs-list-lexicons.html) no *Guia do desenvolvedor do Amazon Polly*.  
+  Consulte detalhes da API em [ListLexicons](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-lexicons.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `list-speech-synthesis-tasks`.

**AWS CLI**  
**Para listar suas tarefas de síntese de fala**  
O exemplo `list-speech-synthesis-tasks` a seguir lista suas tarefas de síntese de fala.  

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

```
{
    "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 obter mais informações, consulte [Criar arquivos de áudio longos](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) no *Guia do desenvolvedor do Amazon Polly*.  
+  Para ver detalhes da API, consulte [ListSpeechSynthesisTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-speech-synthesis-tasks.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `put-lexicon`.

**AWS CLI**  
**Como armazenar um léxico**  
O exemplo de `put-lexicon` a seguir armazena o léxico de pronúncia especificado. O arquivo `example.pls` especifica um léxico compatível com o PLS do W3C.  

```
aws polly put-lexicon \
    --name w3c \
    --content file://example.pls
```
Conteúdo 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 não produz saída.  
Para obter mais informações, consulte [Uso da operação PutLexicon](https://docs.aws.amazon.com/polly/latest/dg/gs-put-lexicon.html) no *Guia do desenvolvedor do Amazon Polly*.  
+  Consulte detalhes da API em [PutLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/put-lexicon.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `start-speech-synthesis-task`.

**AWS CLI**  
**Como sintetizar texto**  
O exemplo de `start-speech-synthesis-task` a seguir sintetiza o texto em `text_file.txt` e armazena o arquivo MP3 resultante no 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
```
Resultado:  

```
{
    "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 obter mais informações, consulte [Criar arquivos de áudio longos](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) no *Guia do desenvolvedor do Amazon Polly*.  
+  Consulte detalhes da API em [StartSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/start-speech-synthesis-task.html) na *Referência de comandos da AWS CLI*.