> For the complete documentation index, see [llms.txt](https://docs.plumvoice.com/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plumvoice.com/dev/developer-reference/tts-engine-characteristics/at-and-t-natural-voices.md).
# AT\&T Natural Voices
## Voice Tag Attributes
### **\**
This attribute is supported.
### **\**
This attribute is *not* supported.
### **\**
{% hint style="info" %}
If you have an onsite system, please contact your sales account manager for which of these voices you have installed on your server.
{% endhint %}
| Language | Name | Gender | US | UK |
| ------------------------- | -------- | ------ | -- | -- |
| American English (en\_us) | Mel | male | x | - |
| American English (en\_us) | Mike | male | x | x |
| American English (en\_us) | Ray | male | x | x |
| American English (en\_us) | Rich | male | x | - |
| American English (en\_us) | Claire | female | x | - |
| American English (en\_us) | Crystal | female | x | x |
| American English (en\_us) | Julia | female | x | - |
| American English (en\_us) | Lauren | female | x | x |
| Spanish (es\_us) | Alberto | male | x | - |
| Spanish (es\_us) | Rosa | female | x | - |
| British English (en\_uk) | Charles | male | x | x |
| British English (en\_uk) | Anjali | female | x | - |
| British English (en\_uk) | Audrey | female | x | x |
| French (fr\_fr) | Alain | male | x | - |
| French (fr\_fr) | Juliette | female | x | - |
| German (de\_de) | Reiner | male | x | x |
| German (de\_de) | Claudia | female | x | x |
{% hint style="info" %}
If no name is specified, **mike** is the default voice for the US AT\&T Natural Voices while **charles** is the default voice for the UK AT\&T Natural Voices.
{% endhint %}
### \
The `` tag should be used to specify the desired language through the attribute xml:lang=”*lg-CN*”, where *lg-CN* is the language-country pair specified in the Language column from the table of supported languages.
Please note that each voice has an associated language. Selecting a language that is not associated with the voice will result in unpredictable behavior; however, in many cases, you will hear the language the text was written in accented by that voice’s associated language.
### \
The `` tag should be used to specify the desired voice through the attribute name=”*name*”, where *name* is the voice specified in the Name/ID column for the table of supported voices above.
If you want to use another voice within an app, specify it using the `` and `` tags within the prompt block:
```markup
```
To sequentially use multiple languages and voices within a `` block, use multiple `` and `` blocks. For example:
```markup
```
### **\**
{% hint style="info" %}
If you have an onsite system, please contact your sales account manager for which of these languages you have installed on your server.
{% endhint %}
The following languages are supported by their respective engines:
| Language | Name | Gender | US | UK |
| ------------------------- | -------- | ------ | -- | -- |
| American English (en\_us) | Mel | male | x | - |
| American English (en\_us) | Mike | male | x | x |
| American English (en\_us) | Ray | male | x | x |
| American English (en\_us) | Rich | male | x | - |
| American English (en\_us) | Claire | female | x | - |
| American English (en\_us) | Crystal | female | x | x |
| American English (en\_us) | Julia | female | x | - |
| American English (en\_us) | Lauren | female | x | x |
| Spanish (es\_us) | Alberto | male | x | - |
| Spanish (es\_us) | Rosa | female | x | - |
| British English (en\_uk) | Charles | male | x | x |
| British English (en\_uk) | Anjali | female | x | - |
| British English (en\_uk) | Audrey | female | x | x |
| French (fr\_fr) | Alain | male | x | - |
| French (fr\_fr) | Juliette | female | x | - |
| German (de\_de) | Reiner | male | x | x |
| German (de\_de) | Claudia | female | x | x |
For example, use `` to hear an American speaker.
### SSML Tags
An “x” marks that the Child Tag is supported by the speech engine. An asterisk (\*) means that there are notes to explain the difference between the speech engines.
| Child Tag | AT\&T Natural Voices |
| -------------- | -------------------- |
| \\* | x |
| \ | |
| \ | x |
| \ | |
| \\* | x |
| \\* | x |
| \\* | x |
| \\* | x |
| \\* | x |
| \ | x |
| \ | x |
| \ | x |
### \
This tag works as expected for the AT\&T engine.
### \
This tag works as expected for the AT\&T engine.
### \
This tag works uses the Phoneme Set shown below.
***Phoneme Set for AT\&T Natural Voices***:
{% tabs %}
{% tab title="US English (en-US)" %}
| Phoneme | Example | Transcription |
| ------------ | ------- | --------------- |
| aa | Bob | b aa b 1 |
| ae | bat | b ae t 1 |
| ah | but | b ah t 1 |
| ao | bought | b ao t 1 |
| aw | down | d aw n 1 |
| ax | about | ax 0 b aw t 1 |
| ay | bite | b ay t 1 |
| b | bet | b eh t 1 |
| ch | church | ch er ch 1 |
| d | dig | d ih g |
| dh | that | dh ae t 1 |
| dx | butter | b ah 1 dx er 0 |
| eh | bet | b eh t 1 |
| em | Chatham | ch ae 1 dx em 0 |
| en | satin | s ae 1 q en 0 |
| er | bird | b er d 1 |
| ey | bait | b ey t 1 |
| f | fog | f ao g 1 |
| g | got | g aa t 1 |
| hh | hot | h aa t 1 |
| ih | bit | b ih t 1 |
| iy | beat | b iy t 1 |
| jh | jump | jh ah m p 1 |
| k | cat | k ae t 1 |
| l | lot | l aa t 1 |
| m | Mom | m aa m 1 |
| n | nod | n aa d 1 |
| ng | sing | s ih ng 1 |
| ow | boat | b ow t 1 |
| oy | boy | b oy 1 |
| p | pot | p aa t 1 |
| q | button | b ah 1 q en 0 |
| r | rat | r ae t 1 |
| s | sit | s ih t 1 |
| sh | shut | sh ah t 1 |
| t | top | t aa p 1 |
| th | thick | th ih k 1 |
| uh | book | b uh k |
| uw | boot | b uw t 1 |
| v | vat | v ae t 1 |
| w | won | w ah n 1 |
| y | you | y uw 1 |
| z | zoo | z uw 1 |
| zh | measure | m eh 1 zh er |
| {% endtab %} | | |
{% tab title="US Spanish (es-US)" %}
| Symbol | Example | Transcription |
| ------------ | ------- | -------------- |
| p | padre | p a 1 d r e |
| b | vino | b i 1 n o |
| t | tomo | t o 1 m o |
| d | donde | d o n 1 d e |
| k | casa | k a 1 s a |
| g | gata | g a 1 t a |
| tS | mucho | m u 1 tS o |
| jj | hielo | jj e 1 l o |
| f | fácil | f a 1 s i l |
| B | cabra | k a 1 B r a |
| th | cinco | th i N 1 k o |
| T | cinco | T i N 1 k o |
| s | sala | s a 1 l a |
| x | mujer | m u x e r 1 |
| G | luego | l w e 1 G o |
| m | mismo | m i 1 s m o |
| n | nunca | n u n 1 k a |
| J | año | a 1 J o |
| l | lejos | l e 1 x o s |
| ll | caballo | k a b a 1 ll o |
| L | caballo | k a b a 1 L o |
| r | puro | p u 1 r o |
| rr | torre | t o 1 rr e |
| j | rei | rr e 1 j |
| j | pie | p j e 1 |
| w | deuda | d e 1 w d a |
| w | muy | m w i 1 |
| i | pico | p i 1 k o |
| e | pero | p e 1 r o |
| a | valle | b a 1 L e |
| o | toro | t o 1 r o |
| u | duro | d u 1 r o |
| {% endtab %} | | |
{% tab title="UK English (en-UK)" %}
| Phoneme | Example | Transcription |
| ------------- | ------- | --------------- |
| p | point | p OI n t 1 |
| b | big | bIg1 |
| t | team | t i: m 1 |
| d | dare | de\@1 |
| k | case | k eI s 1 |
| g | good | gUd1 |
| dZ | ginger | dZ I n 1 dZ @ 0 |
| tS | check | tS e k 1 |
| f | fool | f u: l 1 |
| v | vest | vest1 |
| D | this | DIs1 |
| T | thick | TIk1 |
| s | sell | sel1 |
| z | zeal | z i: l 1 |
| S | shoot | S u: t 1 |
| Z | measure | me1Z\@0 |
| h | house | h aU s 1 |
| m | main | m eI n 1 |
| n | name | n eI m 1 |
| N | sing | sIN1 |
| l | life | l aI f 1 |
| @l | bottle | b Q 1 t @l 0 |
| r | right | r aI t 1 |
| j | yes | jes1 |
| w | wood | wUd1 |
| i: | beat | b i: t 1 |
| I | bit | bIt1 |
| eI | bait | b eI t 1 |
| e | bet | bet1 |
| A: | father | f A: 1 D @ 0 |
| { | bat | b{t1 |
| @U | boat | b @U t 1 |
| O: | bought | b O: t 1 |
| Q | boss | bQs1 |
| u: | boot | b u: t 1 |
| U | book | bUk1 |
| V | but | bVt1 |
| 3: | bird | b 3: d 1 |
| aU | bout | b aU t 1 |
| OI | boy | b OI 1 |
| aI | bite | b aI t 1 |
| @ | scallop | sk{1l\@p0 |
| I | believe | b I 0 l i: v 1 |
| {% endtab %} | | |
| {% endtabs %} | | |
{% hint style="info" %}
**Key**
0 Unstressed\
1 Primary stress\
2 Secondary stress\
& Word boundary
{% endhint %}
### \
The prosody element works as expected for this engine.
You can specify a preset rate (“fast”, “medium”, “slow”, or “default”). However, using a preset rate is not recommended because it either sets the voice rate to too slow or too fast.
The “rate” attribute can also be set to an integer value such as “100.0” or “50.0”. A normal voice rate should be set to around “150.0”. These values are not in accordance with the SSML spec, where rates are specified relative to 1.
Additionally, you can also adjust the voice rate by using percentages. To increase the rate you could type ”+50%“ to make the voice rate 50% faster or ”-50%“ to make the voice rate 50% slower. Note that the “pitch” attribute does not work for this engine.
### \
The table below shows the `` tag types supported by the AT\&T engine.
| Say-as Tag Types | AT\&T Natural Voices |
| ----------------- | -------------------- |
| acronym\* | x |
| address | x |
| number | x |
| number: cardinal | x |
| number: ordinal | |
| number: digits | |
| number: decimal | x |
| number: fraction | x |
| number: telephone | x |
| date | x |
| date:dmy\* | x |
| date:mdy\* | x |
| date:ymd\* | x |
| date:ym\* | |
| date:my\* | x |
| date:md\* | x |
| date:dm\* | x |
| date:y\* | x |
| date:m | |
| date:d | |
| date:day | |
| digits | |
| duration | |
| duration:h | |
| duration:hm | |
| duration:m | |
| duration:ms | |
| duration:s | |
| measure\* | x |
| name | x |
| net:email | x |
| net:uri\* | x |
| time\* | x |
| time:h | x |
| time:hm | x |
| time:hms | x |
| spell | |
| telephone\* | x |
| currency\* | x |
acronym: The acronym tag type works fine in the US, but does not work in the UK. If you are using AT\&T Natural Voices and you want to spell out words or say back digits in the UK, you would have to use commas inside of a string such as “a, c, r, o, n, y, m” or “1, 2, 3, 4, 5”.
date:mdy: The preferred format of this tag is “month abbreviation day, year”. For example, to return “December 25, 2001”, you would type “Dec 25, 2001”. You can also use the “month/day/year” format such as “12/25/01” for the US, but this format will not work in the UK.
date:dmy: The preferred format of this tag is “day month abbreviation, year”. For example, to return “December 25, 2001”, you would type “25 Dec, 2001”.
date:ymd: The preferred format for this tag is “year month abbreviation day”. For example, to return “December 25, 2001”, you would type “2001, Dec 25”.
date:my: The format of this tag should be “month abbreviation, year”. For example, to return “December, 2001”, you would type “Dec, 2001”.
date:md: The preferred format for this tag is “month abbreviation day”. For example, to return “December 25”, you would type “Dec 25”. You can also use the “month/day” format such as “12/25” for the US, but this format will not work in the UK.
date:dm: The preferred format for this tag is “day month abbreviation”. For example, to return “December 25”, you would type “25 Dec”.
date:ym: The preferred format for this tag is “year/month”. For example, to return “December 2001”, you would type “2001/12”.
date:y: The date:y tag type works fine in the US, but does not work in the UK.
measure: For AT\&T Natural Voices, the preferred format is, for example, 5'4”.
net:uri: For AT\&T Natural Voices, the preferred format is `www.examplewebsite.com`.
time: The time tag type works fine in the US, but does not work in the UK.
telephone: The telephone tag type works fine in the US, but does not work in the UK.
The format for telephone numbers is: 123-456-7890
The format for telephone extensions is: 123-456-7890 ext1234
{% hint style="info" %}
**NOTE**: For extensions, AT\&T Natural Voices says the number back correctly. In the example above, AT\&T Natural Voices will say, “one two three four five six seven eight nine zero, extension one two three four.”
{% endhint %}
currency: When using the say-as type, currency, for AT\&T Natural Voices with a Spanish TTS voice, please keep in mind that you will need to format the currency to $\,\. The currency amount will not be pronounced correctly if you format it as $\.\.
### \
This attribute is supported.