使用 的 Amazon Polly 範例 AWS CLI - AWS Command Line Interface

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 的 Amazon Polly 範例 AWS CLI

下列程式碼範例說明如何搭配 Amazon Polly AWS Command Line Interface 使用 來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會示範如何呼叫個別服務函數,但您可以在其相關案例中查看內容中的動作。

每個範例都包含完整原始程式碼的連結,您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例示範如何使用 delete-lexicon

AWS CLI

若要刪除詞庫

下列delete-lexicon範例會刪除指定的詞庫。

aws polly delete-lexicon \ --name w3c

此命令不會產生輸出。

如需詳細資訊,請參閱 Amazon Polly 開發人員指南 中的使用 DeleteLexicon 操作

  • 如需API詳細資訊,請參閱 命令參考 DeleteLexicon中的 。 AWS CLI

下列程式碼範例示範如何使用 get-lexicon

AWS CLI

擷取詞庫的內容

下列get-lexicon範例會擷取指定發音詞庫的內容。

aws polly get-lexicon \ --name w3c

輸出:

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

如需詳細資訊,請參閱 Amazon Polly 開發人員指南 中的使用 GetLexicon 操作

  • 如需API詳細資訊,請參閱 命令參考 GetLexicon中的 。 AWS CLI

下列程式碼範例示範如何使用 get-speech-synthesis-task

AWS CLI

取得語音合成任務的相關資訊

下列get-speech-synthesis-task範例會擷取指定語音合成任務的相關資訊。

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

輸出:

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

如需詳細資訊,請參閱 Amazon Polly 開發人員指南 中的建立長音訊檔案

下列程式碼範例示範如何使用 list-lexicons

AWS CLI

列出您的詞庫

下列list-lexicons範例列出您的發音詞。

aws polly list-lexicons

輸出:

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

如需詳細資訊,請參閱 Amazon Polly 開發人員指南 中的使用 ListLexicons 操作

  • 如需API詳細資訊,請參閱 命令參考 ListLexicons中的 。 AWS CLI

下列程式碼範例示範如何使用 list-speech-synthesis-tasks

AWS CLI

列出您的語音合成任務

下列list-speech-synthesis-tasks範例列出您的語音合成任務。

aws polly list-speech-synthesis-tasks

輸出:

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

如需詳細資訊,請參閱 Amazon Polly 開發人員指南 中的建立長音訊檔案

下列程式碼範例示範如何使用 put-lexicon

AWS CLI

儲存詞庫

下列put-lexicon範例存放指定的發音詞庫。example.pls 檔案會指定符合 W3C PLS標準的詞庫。

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

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

此命令不會產生輸出。

如需詳細資訊,請參閱 Amazon Polly 開發人員指南 中的使用 PutLexicon 操作

  • 如需API詳細資訊,請參閱 命令參考 PutLexicon中的 。 AWS CLI

下列程式碼範例示範如何使用 start-speech-synthesis-task

AWS CLI

若要合成文字

下列start-speech-synthesis-task範例會在 中合成文字,text_file.txt並將產生的MP3檔案儲存在指定的儲存貯體中。

aws polly start-speech-synthesis-task \ --output-format mp3 \ --output-s3-bucket-name my-s3-bucket \ --text file://text_file.txt \ --voice-id Joanna

輸出:

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

如需詳細資訊,請參閱 Amazon Polly 開發人員指南 中的建立長音訊檔案