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

Exemplos do Amazon Polly usando o 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 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.

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 Uso da operação DeleteLexicon no Guia do desenvolvedor do Amazon Polly.

  • Para obter detalhes da API, consulte DeleteLexicon na Referência de comandos da AWS CLI.

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 Usando a operação GetLexicon no Guia do desenvolvedor do Amazon Polly.

  • Para obter detalhes da API, consulte GetLexicon na Referência de comandos da AWS CLI.

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

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 Uso das operações ListLexicons no Guia do desenvolvedor do Amazon Polly.

  • Para obter detalhes da API, consulte ListLexicons na Referência de comandos da AWS CLI.

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

  • Para obter detalhes da API, consulte PutLexicon na Referência de comandos da AWS CLI.

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

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