Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

支持的 SSML 标签

亚马逊 Polly 支持以下 SSML 标签：

如果您在神经或标准格式中使用不受支持的 SSML 标签，则会出现错误。

标识 SSML 增强文本

<speak>

这个<speak>标签是所有亚马逊 Polly SSML 文本的根元素。所有 SSML 增强文本均位于 <speak> 标签之内。

<speak>Mary had a little lamb.</speak>

神经和标准 TTS 格式都支持此标签。

添加停顿

<break>

神经和标准 TTS 格式都支持此标签。

要向文本添加停顿，请使用 <break> 标签。您可以根据强度设置停顿（等同于逗号、句子或段落后的停顿），也可以将停顿设置为特定的时间长度（以秒为单位或以毫秒为单位）。如果您没有指定属性来确定暂停时长，Amazon Polly 将使用默认值，即<break strength="medium"/>，它在逗号后添加了暂停的长度。

strength 属性值：

time 属性值：

例如：

<speak>
     Mary had a little lamb <break time="3s"/>Whose fleece was white as snow.
</speak>

如果未将属性用于 break 标签，则结果将因文本而异：

强调词语

<emphasis>

只有标准 TTS 格式支持此标记。

要强调词语，请使用 <emphasis> 标签。强调词语会更改语速和音量。更多强调会让 Amazon Polly 说出文字的声音越来越慢。不需强调的内容会读得更轻、更快。请使用 level 属性指定强调程度。

level 属性值：

例如：

<speak>
     I already told you I <emphasis level="strong">really like</emphasis> that person.
</speak>

为特定词语指定另一种语言

<lang>

神经和标准 TTS 格式都支持此标签。

利用 <lang> 标签将特定的词语、短语或句子指定为另一种语言。外语词汇和短语如果放在 <lang> 标签对之间一般会朗读得更好。请使用 xml:lang 属性指定语言。有关可用语言的完整列表，请参阅 亚马逊 Polly 支持的语言。

如果您不应用 <lang> 标签，输入文本中的所有词语将使用 voice-id 中指定的语音的语言朗读。如果您应用 <lang> 标签，将使用这种语言朗读词语。

例如，如果voice-id是乔安娜（会说美国英语），亚马逊 Polly 用没有法语口音的 Joanna 声音说以下话：

<speak>
     Je ne parle pas français.
</speak>

如果你用 Joanna 的声音<lang>标签，亚马逊 Polly 用带有美国口音的法语用乔安娜的声音说出这句话：

<speak>
     <lang xml:lang="fr-FR">Je ne parle pas français.</lang>.
</speak>

因为 Joanna 的母语不是法语，发音会以她的母语为基础，也就是美国英语。例如，虽然完美的法语发音在 français 这个词中有一个小舌颤音 /R/，但 Joanna 的美国英语语音将这个音素发为相应的 /r/。

如果你使用voice-id关于会说意大利语的乔治有以下文字，亚马逊 Polly 用乔治的声音说出这句话，发音是意大利语：

<speak>
     Mi piace Bruce Springsteen.
</speak>

如果你在以下内容中使用相同的声音<lang>标签，亚马逊 Polly 用带意大利口音的英语发音 Bruce Springsteen：

<speak>
     Mi piace <lang xml:lang="en-US">Bruce Springsteen.</lang>
</speak>

此标签也可以用作可选标签的替代品DefaultLangCode合成语音时的选项。但是，这样做需要您使用 SSML 设置文本格式。

在您的文本中插入自定义标签

<mark>

神经和标准 TTS 格式都支持此标签。

要在文本中添加自定义标签，请使用<mark>标签。Amazon Polly 不对标签执行任何操作，但会返回标签在 SSML 元数据中的位置。此标签可以是您希望注明的任何内容，但需要具备以下格式：

<mark name="tag_name"/>

例如，假设标签名称是 "animal"，输入文本是：

<speak>
     Mary had a little <mark name="animal"/>lamb.
</speak>

亚马逊 Polly 可能会返回以下 SSML 元数据：

{"time":767,"type":"ssml","start":25,"end":46,"value":"animal"}

在段落之间添加停顿

<p>

神经和标准 TTS 格式都支持此标签。

要在文本段落之间添加停顿时间，请使用 <p> 标签。使用此标签，停顿时长将长于母语者在逗号或句子结束后停顿的时长。在段落两端使用 <p> 标签：

<speak>
     <p>This is the first paragraph. There should be a pause after this text is spoken.</p> 
     <p>This is the second paragraph.</p> 
</speak>

这与使用 <break strength="x-strong"/> 指定停顿的效果相同。

使用语音发音

<phoneme>

神经和标准 TTS 格式都支持此标签。

<phoneme>要让 Amazon Polly 对特定文本使用语音发音，请使用标签。

<phoneme> 标签需要具有两个属性。它们指示 Amazon Polly 使用的音标和更正发音的音标符号：

随着<phoneme>标签，亚马逊 Polly 使用指定的发音ph属性而不是默认情况下与所选声音使用的语言相关的标准发音。

例如 "pecan" 这个词可以发两个音。在以下示例中，“pecan” 在每行中被分配了不同的发音。亚马逊 Polly 按照中规定的方式发音山核桃ph属性，而不是使用默认发音。

国际音标 (IPA)

<speak>
     You say, <phoneme alphabet="ipa" ph="pɪˈkɑːn">pecan</phoneme>. 
     I say, <phoneme alphabet="ipa" ph="ˈpi.kæn">pecan</phoneme>.
</speak>

拓展音标字母评估法 (X-SAMPA)

<speak>
     You say, <phoneme alphabet='x-sampa' ph='pI"kA:n'>pecan</phoneme>.
     I say, <phoneme alphabet='x-sampa' ph='"pi.k{n'>pecan</phoneme>. 
</speak>

汉语普通话使用拼音发音。

拼音

<speak>
     你说 <phoneme alphabet="x-amazon-pinyin" ph="bo2">薄</phoneme>。 
     我说 <phoneme alphabet="x-amazon-pinyin" ph="bao2">薄</phoneme>。
</speak>

日语使用读音假名和发音假名。

Yomigana

<speak>
     名前は<phoneme alphabet="x-amazon-yomigana" ph="ひろかず">浩一</phoneme>です。
     名前は<phoneme alphabet="x-amazon-yomigana" ph="ヒロカズ">浩一</phoneme>です。
     名前は<phoneme alphabet="x-amazon-yomigana" ph="Hirokazu">浩一</phoneme>です。
</speak>

发音假名

<speak>
     名前は<phoneme alphabet="x-amazon-pron-kana" ph="ヒロカ'ズ">浩一</phoneme>です。
</speak>

控制音量、语速和音高

<prosody>

标准 TTS 语音完全支持 Prosody 标签属性。神经语音支持volume和rate属性，但不支持pitch属性。

要控制所选语音的音量、语速或音高，请使用 prosody 标签。

音量、语速和音高取决于所选的具体语音。不同语言的语音各有不同，说同一语言的不同人之间也各不相同。因此，虽然所有语言的属性都是类似的，但各种语言之间的差异很明显，没有适用于所有语言的值。

prosody 标签有三个属性，每个属性均有若干可用的设置值。每个属性使用相同的语法：

<prosody attribute="value"></prosody>

<prosody> 标签必须至少包含一个属性，但同一标签中可包含更多属性。

<speak>
     Each morning when I wake up, <prosody volume="loud" rate="x-slow">I speak  
     quite slowly and deliberately until I have my coffee.</prosody>
</speak>

还可使用嵌套标签进行组合，例如：

<speak>
     <prosody rate="85%">Sometimes combining attributes <prosody pitch="-10%">can 
     change the impression your audience has of a voice</prosody> as well.</prosody>                  
</speak>

为合成语音设置最长持续时间

<prosody amazon:max-duration>

目前只有标准 TTS 格式支持此标签。

要控制您希望语音在合成后花费多长时间，请使用具有 <prosody> 属性的 amazon:max-duration 标签。

合成的语音的持续时间会因您选择的语音而略有不同。这样很难使合成的语音与需要精确计时的视觉效果或其他活动匹配。对于翻译应用程序来说，此问题被扩大，因为使用不同语言说特定短语所需的时间可能大不相同。

<prosody amazon:max-duration> 标签使合成的语音与所需的时间量（持续时间）匹配。

此标签使用以下语法：

<prosody amazon:max-duration="time duration">

使用 <prosody amazon:max-duration> 标签，您可以指定持续时间，以秒或毫秒为单位：

例如，以下说出的文本的最长持续时间为 2 秒：

<speak>
     <prosody amazon:max-duration="2s">
          Human speech is a powerful way to communicate. 
     </prosody>
</speak>

放置在标签中的文本没有超过指定的持续时间。如果选定的语音或语言通常需要超过该持续时间，则 Amazon Polly 会加快语音速度，使其适合指定的时长。

如果指定的持续时间长于以正常速率读取文本所需的时间，则 Amazon Polly 会正常读取语音。它不会减慢语音或添加静默，因此生成的音频比请求的短。

您可以在 <prosody amazon:max-duration> 标签中包括单个句子或多个句子，并且可以在文本中使用多个 <prosody amazon:max-duration> 标签。

例如：

<speak>
     <prosody amazon:max-duration="2400ms">
        Human speech is a powerful way to communicate.
     </prosody>
     <break strength="strong"/>
     <prosody amazon:max-duration="5100ms">
        Even a simple ‘Hello’ can convey a lot of information depending on the pitch, intonation, and tempo.
     </prosody>
     <break strength="strong"/>
     <prosody amazon:max-duration="8900ms">
        We naturally understand this information, which is why speech is ideal for creating applications where 
        a screen isn’t practical or possible, or simply isn’t convenient.
     </prosody>
</speak>

使用<prosody amazon:max-duration>当 Amazon Polly 返回合成语音时，标签可能会增加延迟。延迟程度取决于段落及其长度。我们建议使用由较短文本段落组成的文本。

限制

在如何使用 <prosody amazon:max-duration> 标签及其如何与其他 SSML 标签结合使用方面存在限制：

停顿和 max-duration

当使用 max-duration 标签时，您仍可以在文本中插入停顿。但是，在计算最长语音持续时间时，Amazon Polly 会将暂停时长包括在内。此外，Amazon Polly 保留了在段落中放置逗号和句点的短暂停顿时间，也包括在最长持续时间内。

例如，在下面的数据块中，在 8 秒语音中出现由逗号和句号引起的 600 毫秒中断：

<speak>
     <prosody amazon:max-duration="8s">
          Human speech is a powerful way to communicate.
          <break time="600ms"/>
          Even a simple ‘Hello’ can convey a lot of information depending on the pitch, intonation, and tempo.
     </prosody>
</speak>  

在句子之间添加停顿

<s>

神经和标准 TTS 格式都支持此标签。

要在行与行或句子与句子之间添加停顿，请使用 <s> 标签。使用此标签的效果与以下情况效果相同：

与 <break> 标签不同，<s> 标签要放在句子两端。对于按行朗读的文本这种语音合成方法很有用，例如诗歌。

在以下示例中，<s> 标签在第一句和第二句之后加入一个短的停顿。最后一个句子没有 <s> 标签，但它后面也有一个短停顿，因为它以句点结尾。

<speak>
     <s>Mary had a little lamb</s> 
     <s>Whose fleece was white as snow</s> 
     And everywhere that Mary went, the lamb was sure to go.
</speak>  

控制如何朗读特殊的词语类型

<say-as>

除了“字符”或“拼写”功能外，此标签由神经和标准 TTS 格式提供支持。如果 Amazon Polly 在运行时遇到此 SSML 代码，则将使用相关的标准语音合成受影响的句子。但请注意，这句话仍然会按照使用神经语音的情况收费。

使用<say-as>用 the 标记interpret-as属性告诉亚马逊 Polly 如何说出某些字符、单词和数字。这使您能够提供额外的上下文，以消除有关 Amazon Polly 应如何呈现文本的任何歧义。

say-as 标签使用一个属性 <interpret-as>，该属性使用若干可能可用的值。每个属性使用相同的语法：

<say-as interpret-as="value">[text to be interpreted]</say-as>

interpret-as 具有以下可用值：

分数

亚马逊 Polly 会解释其中的值say-as有以下内容的标签interpret-as="fraction"属性为常用分数。分数采用以下语法形式：

日期

如果将 interpret-as 设为 date，您还需要指明日期格式。

它使用以下语法：

<say-as interpret-as="date" format="format">[date]</say-as>

例如：

<speak>
     I was born on <say-as interpret-as="date" format="mdy">12-31-1900</say-as>.
</speak>

下列格式可以与 date 属性一起使用。

电话

Amazon Polly 会尝试根据文本的格式正确解释您提供的文本，即使没有<say-as>标签。例如，如果您的文本包含 “202-555-1212”，则 Amazon Polly 会将其解释为 10 位数的电话号码，并分别说出每个数字，每个短划线会短暂停一下。在这种情况下，您不需要使用 <say-as interpret-as="telephone">。但是，如果您提供文本 “2025551212” 并希望亚马逊 Polly 将其作为电话号码说出来，则需要指定<say-as interpret-as="telephone">。

解释每种元素的逻辑是语言特定的。例如，在美国英语和英国英语中，电话号码的发音方法不同 (在英国英语中，同一数字会组成一组，例如“两个五”或“三个四”)。要了解差别，请使用美国语音和英国语音测试以下示例：

<speak>
     Richard's number is <say-as interpret-as="telephone">2122241555</say-as>
</speak>

首字母缩略词和缩写的发音

<sub>

神经和标准 TTS 格式都支持此标签。

使用具有 <sub> 属性的 alias 标签，用另一个词（或发音）替换选定文本，例如首字母缩略词或缩写。

使用以下语法：

<sub alias="new word">abbreviation</sub>

在以下示例中，将用“Mercury”替换元素的化学符号，以使音频内容更加清晰。

<speak>
     My favorite chemical element is <sub alias="Mercury">Hg</sub>, because it looks so shiny. 
</speak>

指定词性以改善发音

<w>

神经和标准 TTS 格式都支持此标签。

可使用 <w> 标签来自定义词语的发音，方式是指定词语的词性或替代含义。可使用 role 属性执行此操作。

此标签使用以下语法：

<w role="attribute">text</w>

下列值可以用于 role 属性：

要指定词性，请执行以下操作：

例如，美国英语对单词“read”的发音会根据标签的不同有所变化，具体取决于词性：

<speak>
     The word <say-as interpret-as="characters">read</say-as> may be interpreted 
     as either the present simple form <w role="amazon:VB">read</w>, or the past 
     participle form <w role="amazon:VBD">read</w>.
</speak>

要指定具体含义，请执行以下操作：

如果你综合以下内容，就能听出发音和含义的这种差异：

<speak>
    Depending on your meaning, the word <say-as interpret-as="characters">bass</say-as> 
    may be interpreted as either a musical element: bass, or as its alternative meaning, 
    a freshwater fish <w role="amazon:SENSE_1">bass</w>.
</speak>

添加呼吸音

<amazon:breath> 和 <amazon:auto-breaths>

只有标准 TTS 格式支持此标记。

自然声音语音包括正确说出的字词和呼吸音。通过向合成语音添加呼吸音，可以使合成语音听起来更自然。<amazon:breath> 和 <amazon:auto-breaths> 标签可提供呼吸。您有以下选项：

手动模式

在手动模式下，可将 <amazon:breath/> 标签放在要插入呼吸的输入文本中。您可以分别使用 duration 和 volume 属性自定义呼吸的长度和音量：

要使用默认值设置呼吸音，请不带属性使用 <amazon:breath/>。

例如，要使用属性将呼吸的持续时间和音量设置为中等，可以按如下方式设置属性：

<speak>
     Sometimes you want to insert only <amazon:breath duration="medium" volume="x-loud"/>a single breath.
</speak>

要使用默认值，只需使用标签：

<speak>
     Sometimes you need <amazon:breath/>to insert one or more average breaths <amazon:breath/> so that the 
     text sounds correct.
</speak>

您可以在一个段落内添加个别呼吸音，如下所示：

<speak>
     <amazon:breath duration="long" volume="x-loud"/> <prosody rate="120%"> <prosody volume="loud"> 
     Wow! <amazon:breath duration="long" volume="loud"/> </prosody> That was quite fast. <amazon:breath 
     duration="medium" volume="x-loud"/> I almost beat my personal best time on this track. </prosody>
</speak>

自动模式

在自动模式下，您可以使用<amazon:auto-breaths>标签告诉亚马逊 Polly 以适当的间隔自动产生呼吸噪音。您可以设置间隔的频率、音量和持续时间。将 </amazon:auto-breaths> 标签放在要应用自动呼吸的文本的开头，然后将结束标签放在文本末尾。

您可以将以下可选属性与 <amazon:auto-breaths> 标签结合使用：

默认情况下，呼吸音的频率取决于输入文本。但是，呼吸音通常发生在逗号和句点之后。

以下示例显示如何使用 <amazon:auto-breaths> 标签。要决定为您的内容使用哪些选项，请将适用的示例复制到 Amazon Polly 控制台并听取差异。

播音员风格

<amazon:domain name="news">

新闻播音员风格仅适用于 Matthew 或 Joanna 的声音，它们仅有美式英语 (en-US)、Lupe 的美国西班牙语 (es-US) 和艾米的英式英语 (en-GB) 版本。仅在使用 Neural 格式时支持。

要使用播音员风格，请使用 SSML 标签和以下语法：

<amazon:domain name="news">text</amazon:domain>

例如，你可以使用带有艾米声音的新闻播音员风格，如下所示：

<speak> 
<amazon:domain name="news"> 
From the Tuesday, April 16th, 1912 edition of The Guardian newspaper: 

The maiden voyage of the White Star liner Titanic, the largest ship ever launched, has ended in disaster. 

The Titanic started her trip from Southampton for New York on Wednesday. Late on Sunday night she struck 
an iceberg off the Grand Banks of Newfoundland. By wireless telegraphy she sent out signals of distress, 
and several liners were near enough to catch and respond to the call.
</amazon:domain> 
</speak> 

添加动态范围压缩

<amazon:effect name="drc">

神经和标准 TTS 格式都支持此标签。

根据音频文件中使用的文本、语言和语音，声音范围从轻柔到响亮。环境声音，如一辆正在行驶的车辆的声音，通常可以掩盖较轻柔的声音，从而使得音轨难以听清。要增强音频文件中某些声音的音量，请使用动态范围压缩 (drc) 标签。

drc 标签可为您的音频设置中等“响度”阈值，并且围绕该阈值增大声音的音量（增益）。它将应用最接近于该阈值的最大增益增加，而且增益增加远远小于该阈值。

这使得中等声音在嘈杂环境中更易于听见，从而使整个音频文件更清晰。

drc 标签是一个布尔值参数 (既可能存在，也可能不存在)。它使用语法 <amazon:effect name="drc"> 且以 </amazon:effect> 结束。

你可以使用drc使用亚马逊 Polly 支持的任何语音或语言进行标记。可以将该标签应用于整个录音部分，或仅应用于几个词。例如：

<speak>
     Some audio is difficult to hear in a moving vehicle, but <amazon:effect name="drc"> this audio 
     is less difficult to hear in a moving vehicle.</amazon:effect>
</speak>

结合使用 drc 和 prosody volume 标签

如下图所示，prosody volume 标签均匀增大整个音频文件的音量，从原始音量级别 (虚线) 增大到调节后的音量级别 (实线)。要进一步增大该文件中特定部分的音量，请结合使用 drc 标签和 prosody volume 标签。结合使用标签不会影响 prosody volume 标签的设置。

当你使用drc和prosody volume标签放在一起，亚马逊 Polly 应用了drc首先标记，增加中音声音（接近阈值的声音）。然后，再应用 prosody volume 标签，进一步均匀增大整个音轨的音量。

要结合使用这两个标签，可将一个标签嵌入另一个标签中。例如：

<speak>
     <prosody volume="loud">This text needs to be understandable and loud. <amazon:effect name="drc">
     This text also needs to be more understandable in a moving car.</amazon:effect></prosody> 
</speak>

在本文中，prosody volume 标签将整段的音量增大为“响亮”。drc 标签增强第二句中中等值的音量。

柔和地朗读

<amazon:effect phonation="soft">

目前只有标准 TTS 格式支持此标签。

要指定输入文本应使用softer-than-normal语音，使用<amazon:effect phonation="soft">标签。

使用以下语法：

<amazon:effect phonation="soft">text</amazon:effect>

例如，您可以将此标签用于 Matthew 语音，如下所示：

<speak>
     This is Matthew speaking in my normal voice. <amazon:effect phonation="soft">This 
     is Matthew speaking in my softer voice.</amazon:effect>
</speak>

控制音质

<亚马逊:效果vocal-tract-length>

目前只有标准 TTS 格式支持此标签。

音色是声音的音质，可帮助您区分不同的声音，即使当这些声音具有相同的音高和响度时。影响到语音音色的最重要生理特征之一是声道的长度。声道是空气从声带的顶部直到嘴唇边缘跨越的一个腔体。

要控制 Amazon Polly 中输出语音的音色，请使用vocal-tract-length标签。此标签可更改发言者声道的长度，这听起来类似于更改发言者的身高。增加 vocal-tract-length 时，发言者听上去像是个子更高。减小时，发言者听上去像是个子更矮。您可以将此标签与 Amazon Polly 文字转语音组合中的任何语音一起使用。

要更改音色，请使用以下值：

以下示例演示了如何更改声道长度来更改音色：

<speak>
     This is my original voice, without any modifications. <amazon:effect vocal-tract-length="+15%"> 
     Now, imagine that I am much bigger. </amazon:effect> <amazon:effect vocal-tract-length="-15%"> 
     Or, perhaps you prefer my voice when I'm very small. </amazon:effect> You can also control the 
     timbre of my voice by making minor adjustments. <amazon:effect vocal-tract-length="+10%"> 
     For example, by making me sound just a little bigger. </amazon:effect><amazon:effect 
     vocal-tract-length="-10%"> Or, making me sound only somewhat smaller. </amazon:effect> 
</speak>

结合使用多个标签

你可以组合vocal-tract-length使用亚马逊 Polly 支持的任何其他 SSML 标签进行标记。由于音色 (声道长度) 与音高具有紧密联系，通过结合使用 vocal-tract-length 和 <prosody pitch> 标签，您可能会得到最佳效果。为了生成最真实的语音，建议您对这两个标签使用不同的更改百分比。试用各种组合，以得到希望的最佳效果。

以下示例演示如何结合使用标签。

<speak> 
     The pitch and timbre of a person's voice are connected in human speech.
     <amazon:effect vocal-tract-length="-15%"> If you are going to reduce the vocal tract length, 
     </amazon:effect><amazon:effect vocal-tract-length="-15%"> <prosody pitch="+20%"> you 
     might consider increasing the pitch, too. </prosody></amazon:effect>  
     <amazon:effect vocal-tract-length="+15%"> If you choose to lengthen the vocal tract, 
     </amazon:effect> <amazon:effect vocal-tract-length="+15%"> <prosody pitch="-10%"> 
     you might also want to lower the pitch. </prosody></amazon:effect>
</speak>

轻读

<amazon:effect name="whispered">

目前只有标准 TTS 格式支持此标签。

此标签表示输入文本应使用低声而不是正常语音说出。这可以用于 Amazon Polly 文字转语音组合中的任何语音。

它使用以下语法：

<amazon:effect name="whispered">text</amazon:effect>

例如：

<speak>
     <amazon:effect name="whispered">If you make any noise, </amazon:effect> 
     she said, <amazon:effect name="whispered">they will hear us.</amazon:effect>
</speak>

在这种情况下，角色说出的合成语音是低声的，但是 “她说” 这句话是用选定的 Amazon Polly 语音的普通合成语音说出的。

您可以通过将韵律结构速度降低最多 10% 来增强“低声”效果，具体视您期望的效果而定。

例如：

<speak>
     When any voice is made to whisper, <amazon:effect name="whispered">
     <prosody rate="-10%">the sound is slower and quieter than normal speech
     </prosody></amazon:effect>
</speak>

在为低声语音生成语音标记时，音频流还必须包括低声语音，以确保语音标记与音频流匹配。