Esempi per Amazon Polly con AWS CLI - AWS Command Line Interface
Operazioni

Esempi per Amazon Polly con AWS CLI

L’esempio di codice seguente mostra come eseguire operazioni e implementare scenari comuni utilizzando AWS Command Line Interface con Amazon Polly.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare delete-lexicon.

AWS CLI

Come eliminare un lessico

Nell’esempio seguente delete-lexicon elimina il lessico specificato.

aws polly delete-lexicon \
    --name w3c

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Uso dell’operazione DeleteLexicon nella Guida per sviluppatori di Amazon Polly.

  • Per informazioni dettagliate sull’API, consulta DeleteLexicon in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-lexicon.

AWS CLI

Come recuperare il contenuto di un lessico

Nell’esempio seguente get-lexicon recupera il contenuto del lessico di pronuncia specificato.

aws polly get-lexicon \
    --name w3c

Output:

{
    "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
    }
}

Per ulteriori informazioni, consulta Uso dell’operazione GetLexicon nella Guida per sviluppatori di Amazon Polly.

  • Per informazioni dettagliate sull’API, consulta GetLexicon in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-speech-synthesis-task.

AWS CLI

Come ottenere informazioni su un’attività di sintesi vocale

Nell’esempio seguente get-speech-synthesis-task recupera le informazioni sull’attività di sintesi vocale specificata.

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

Output:

{
    "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"
    }
}

Per ulteriori informazioni, consulta Creazione di file audio di grandi dimensioni nella Guida per sviluppatori di Amazon Polly.

L’esempio di codice seguente mostra come utilizzare list-lexicons.

AWS CLI

Come elencare i lessici correnti

Nell’esempio seguente list-lexicons elenca i lessici di pronuncia in uso.

aws polly list-lexicons

Output:

{
    "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
            }
        }
    ]
}

Per ulteriori informazioni, consulta Uso dell’operazione ListLexicons nella Guida per sviluppatori di Amazon Polly.

  • Per informazioni dettagliate sull’API, consulta ListLexicons in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-speech-synthesis-tasks.

AWS CLI

Come elencare le tue attività di sintesi vocale

L’esempio list-speech-synthesis-tasks seguente elenca le attività di sintesi vocale.

aws polly list-speech-synthesis-tasks

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Creazione di file audio di grandi dimensioni nella Guida per sviluppatori di Amazon Polly.

L’esempio di codice seguente mostra come utilizzare put-lexicon.

AWS CLI

Come archiviare un lessico

Nell’esempio seguente put-lexicon memorizza il lessico di pronuncia specificato. Il file example.pls specifica un lessico conforme a W3C PLS.

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

Contenuto di 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>
}

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Uso dell’operazione PutLexicon nella Guida per sviluppatori di Amazon Polly.

  • Per informazioni dettagliate sull’API, consulta PutLexicon in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare start-speech-synthesis-task.

AWS CLI

Come sintetizzare il testo

Nell’esempio seguente start-speech-synthesis-task sintetizza il testo in text_file.txt e memorizza il file MP3 risultante nel bucket specificato.

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

Output:

{
    "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"
    }
}

Per ulteriori informazioni, consulta Creazione di file audio di grandi dimensioni nella Guida per sviluppatori di Amazon Polly.