Exemplos do Amazon Polly usando AWS CLI - AWS Command Line Interface
Ações

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

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 funções 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, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

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 no Amazon Polly Developer Guide.

  • Para API obter detalhes, consulte DeleteLexiconna Referência de AWS CLI Comandos.

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

AWS CLI

Como 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 no Amazon Polly Developer Guide.

  • Para API obter detalhes, consulte GetLexiconna Referência de AWS CLI Comandos.

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/my-s3-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 no Guia do desenvolvedor do Amazon Polly.

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

AWS CLI

Como 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 no Amazon Polly Developer Guide.

  • Para API obter detalhes, consulte ListLexiconsna Referência de AWS CLI Comandos.

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 list-speech-synthesis-tasks exemplo 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/my-s3-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 no Guia do desenvolvedor do Amazon Polly.

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 example.pls arquivo especifica um léxico compatível com o W3CPLS.

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 no Amazon Polly Developer Guide.

  • Para API obter detalhes, consulte PutLexiconna Referência de AWS CLI Comandos.

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 my-s3-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/my-s3-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 no Guia do desenvolvedor do Amazon Polly.