

Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Exemplos do Amazon Polly usando AWS CLI
<a name="cli_2_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_2_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 Como [usar a DeleteLexicon operação](https://docs.aws.amazon.com/polly/latest/dg/gs-delete-lexicon.html) no *Amazon Polly Developer* Guide.  
+  Para obter detalhes da API, consulte [DeleteLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/delete-lexicon.html)em *Referência de AWS CLI Comandos*. 

### `get-lexicon`
<a name="polly_GetLexicon_cli_2_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
```
Saída:  

```
{
    "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 Como [usar a GetLexicon operação](https://docs.aws.amazon.com/polly/latest/dg/gs-get-lexicon.html) no *Amazon Polly Developer* Guide.  
+  Para obter detalhes da API, consulte [GetLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-lexicon.html)em *Referência de AWS CLI Comandos*. 

### `get-speech-synthesis-task`
<a name="polly_GetSpeechSynthesisTask_cli_2_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
```
Saída:  

```
{
    "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*.  
+  Para obter detalhes da API, consulte [GetSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-speech-synthesis-task.html)em *Referência de AWS CLI Comandos*. 

### `list-lexicons`
<a name="polly_ListLexicons_cli_2_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
```
Saída:  

```
{
    "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 Como [usar a ListLexicons operação](https://docs.aws.amazon.com/polly/latest/dg/gs-list-lexicons.html) no *Amazon Polly Developer* Guide.  
+  Para obter detalhes da API, consulte [ListLexicons](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-lexicons.html)em *Referência de AWS CLI Comandos*. 

### `list-speech-synthesis-tasks`
<a name="polly_ListSpeechSynthesisTasks_cli_2_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
```
Saída:  

```
{
    "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 obter detalhes da API, consulte [ListSpeechSynthesisTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-speech-synthesis-tasks.html)em *Referência de AWS CLI Comandos*. 

### `put-lexicon`
<a name="polly_PutLexicon_cli_2_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 Como [usar a PutLexicon operação](https://docs.aws.amazon.com/polly/latest/dg/gs-put-lexicon.html) no *Amazon Polly Developer* Guide.  
+  Para obter detalhes da API, consulte [PutLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/put-lexicon.html)em *Referência de AWS CLI Comandos*. 

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

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

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

```
{
    "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*.  
+  Para obter detalhes da API, consulte [StartSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/start-speech-synthesis-task.html)em *Referência de AWS CLI Comandos*. 