Amazon Polly 示例使用 AWS CLI - AWS Command Line Interface

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

Amazon Polly 示例使用 AWS CLI

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

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

Scenarios (案例) 是向您展示如何呼叫相同服務中的多個函數來完成特定任務的程式碼範例。

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

主題

動作

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

AWS CLI

若要刪除詞典

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

aws polly delete-lexicon \ --name w3c

此命令不會產生輸出。

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

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

下列程式碼範例會示範如何使用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 詳細資訊,請參閱AWS CLI 命令參考GetLexicon中的。

下列程式碼範例會示範如何使用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 詳細資訊,請參閱AWS CLI 命令參考ListLexicons中的。

下列程式碼範例會示範如何使用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 PL 兼容詞典。

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 詳細資訊,請參閱AWS CLI 命令參考PutLexicon中的。

下列程式碼範例會示範如何使用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 開發人員指南中的建立長音訊檔案