tencent cloud

All product documents
Tencent Cloud AI Digital Human
DocumentationTencent Cloud AI Digital HumanDigital Human SSML Markup Language Specification
Digital Human SSML Markup Language Specification
Download PDF
Last updated: 2025-03-28 16:41:55
Digital Human SSML Markup Language Specification
Last updated: 2025-03-28 16:41:55
Download PDF

<phoneme>

Description
Used to control the specific pronunciation of text, supporting a length of 1 character.
<Tag Relationship>
Empty tag, only contains text, does not include other tags.
Attribute
Name
Parameter Value
Required or Not
Description
alphabet
py
Yes
Specify the pinyin way
ph
Pinyin string
Yes
Comply with pinyin writing norm
Pinyin strings separated by spaces, and the number of pinyin strings is equal to the number of characters.
Pinyin consists of pronunciation and tone, with the tone ranging from 1 to 5, representing the first, second, third, fourth tones and the neutral tone respectively.
Example
This bank will periodically upload records to the People's Bank of China every month.

<break>

Description
Tags used for customizing the insertion of pauses in text content except punctuation. Insert after text content except punctuation.
<Tag Relationship>
Empty tag, does not include other tags.
Attribute
Name
Parameter Value
Required or Not
Description
time
Pause time
No
Specify the duration of the pause at the specific location. The unit is required :
ms (millisecond), s (second)
strength
x-weak/weak/medium/strong/x-strong
No
The prosodic property that indicates a pause at the current position defaults to medium.
Example 1
Custom pause <break time="100ms"/> SSML tag
Example 2
Custom pause <break strength="weak"/> SSML tag

<word>

Description
The word structure used to represent text. This tag is optional. English text usually uses spaces for segmentation. Generally, there is no need to use this tag. The <word> tag must contain an independent word or phrase, which can only be in pure Chinese or pure English, and cannot be mixed Chinese and English.
<Tag Relationship>
Contains text, nestable insert-action.
Attribute
No attribute

Example 1
Mayor of Guangzhou <word>Chimelong Circus</word> Welcomes You

<sub>

Description
Replace the text in the tag with an alias.
<Tag Relationship>
Contains text, nestable insert-action.
Attribute
Name
Parameter Value
Required or Not
Description
alias
Replace content
Yes
The specified text to be replaced
Example 1
<speak><sub alias="Text To Speech">TTS</sub></speak>

<say-as>

Description
Used to control the pronunciation of text according to the specified type or rule.
<Tag Relationship>
Only contain text, excluding any tags.
Attribute
Name
Parameter Value
Required or Not
Description
interpret-as
cardinal/digits/telephone/address/id/date/time/punctuation/characters/measure/currency
Yes
cardinal: Pronounce as an integer or decimal.
digits: Pronounce as digits.
telephone: Pronounce in the commonly used method for phone numbers. address: Address format. id: ID Number format. date: Date format. time: Time format. punctuation: Punctuation format. characters: Character format. measure: Measurement unit format. currency: Currency format.

Support Scope of Each Parameter

cardinal

Format
Example
Output
Digit string
123
One hundred and twenty-three
Negative sign + digit string + decimal
-123.01
Negative one hundred and twenty-three point zero one
Negative sign + numeric string
-1487
Negative one thousand four hundred and eighty-seven
Support separators
10,000
Ten thousand

digits

Format
Example
Output
Digit string
123045
123045

telephone

Format
Example
Output
Description
Landline number
5605560
560 5560
Support 7 to 8 digit landline numbers. Space and '-' are supported as delimiters. Among them: The 7-digit landline number supports the digit separation method of "3-4". The 8-digit landline number supports the digit separation method of "4-4".
560 5560
560 5560
560-5560
560 5560
55605560
5560 5560
5560 5560
5560 5560
5560-5560
5560 5560
Landline number + extension number
55605560-105
5650 5650 Transfer to 105
1. Support extension numbers from 1 to 4 digits. 2. Partial In the pronunciation of the voice type, "transfer" and "extension number" are omitted.
55605560 transfer 105
5650 5650 Transfer to 105
55605560 extension 105
5650 5650 Transfer to 105
55605560 extension number 105
5650 5650, extension number 105
Area code + Landline number
01055605560
Zero one zero, five five six zero, five five six zero
Supported area codes: 010, 02x, 03xx, 04xx, 05xx, 07xx, 08xx, 09xx.
010 55605560
Zero one zero, five five six zero, five five six zero
010-5560-5560
Zero one zero, five five six zero, five five six zero
(010)55605560
Zero one zero, five five six zero, five five six zero
031955605560
Zero three one nine, five five six zero, five five six zero
0319-55605560
Zero three one nine, five five six zero, five five six zero
Area code + Landline number + Extension number
010 33878528-1054
Zero one zero, three three eight seven, eight five two eight, transfer one zero five four
1. Partial In the pronunciation of the voice type, "transfer" and "extension number" are omitted.
010-33878528-1054
Zero one zero, three three eight seven, eight five two eight, transfer one zero five four
(010)33878528-1054
Zero one zero, three three eight seven, eight five two eight, transfer one zero five four
Transfer 1054, (010) 33878528
Zero one zero, three three eight seven, eight five two eight, transfer one zero five four
Extension 1054, (010) 33878528
010 3387 8528 extension 1054
Extension number 1054, (010) 33878528
010-3387-8528 ext. 1054
Country code + Area code + Landline number
86-010-33878528
Zero six, two one, three three eight seven, eight five two eight, transfer one zero five four
Support country codes: 86, (86), +86, (+86), 0086. Read as "eight six" uniformly.
(86)10-33878528
Zero six, zero two one, three three eight seven, eight five two eight, transfer one zero five four
+86-010-33878528
Zero six, zero two one, three three eight seven, eight five two eight, transfer one zero five four
0086-10-33878528
Zero six, two one, three three eight seven, eight five two eight, extension number one zero five four
(+86)-10-3387 8528
Zero six, two one, three three eight seven, eight five two eight, extension number one zero five four
Country code + Area code + Landline number + Extension number
(86)21-33878528-1054
Zero six, two one, three three eight seven, eight five two eight, transfer one zero five four
Partially In the pronunciation of the voice type, "transfer" and "extension number" are omitted.
(86)021-3387-8528-1054
Zero six, zero two one, three three eight seven, eight five two eight, transfer one zero five four
Transfer 1054, (86) 021-33878528
Zero six, zero two one, three three eight seven, eight five two eight, transfer one zero five four
Extension number 1054, (86) 21-3387-8528
Zero six, two one, three three eight seven, eight five two eight, extension number one zero five four
+86-021-3387-8528, extension 1054
Zero six, two one, three three eight seven, eight five two eight, extension number one zero five four
Phone Number
151 8828 1075
Zero five one, eight eight two eight, one zero seven five
Support 11-digit phone numbers and two kinds of number separation methods: 3-3-5, 3-4-4.
151-882-81075
Zero five one, eight eight two, eight one zero seven five
151-8828-1075
Zero five one, eight eight two eight, one zero seven five
Country code + Mobile number
+86-15188281075
86, zero five one, eight eight two eight, eight one zero seven five
The pronunciation of some voices varies slightly.
(+86)-151-8828-1075
86, zero five one, eight eight two eight, eight one zero seven five
+8615188281075
86, zero five one, eight eight two eight, eight one zero seven five
0086-151 882 81075
86, zero five one, eight eight two eight, eight one zero seven five
Service Account
110
One one zero
1. Support frequently used Service accounts such as 110. 2. Support 10-digit Service accounts starting with 400/800, and support the digit separation method of "3-3-4". 3. Support 16-digit numbers starting with 12530/17951/12593.
95566
95566
4008110280
400 811 0280
800-810-8888
800-810-8888
1253013520638377
Zero two five three zero, zero three five, two zero six three, eight three seven seven
Other
(86)(21)8832-80976-0907
Eight six, two one, eight eight three two, eight zero nine seven six, zero nine zero seven
Support the method of "numeric string + separator (parentheses, -)". The pronunciation of some voice types varies slightly

address

Format
Example
Output
Description
Address format
Sunshine Seaview Building A, Room 3-605
Sunshine Seaview Building A, Room 3-605
Support common address formats. Here, the address refers to the standard mailing address. The pronunciation of some voice types varies slightly.
No. 1001 - 1008, Lane 388, Xuefu Road
No. 1001-1008, Lane 388, Xuefu Road

id

Format
Example
Output
Description
New Character String
hello0101
H E L L O 0 1 0 1
Uppercase and lowercase English characters, Arabic numerals 0 to 9, underscore. Insert pause between each character. Partial voice type pronunciation varies slightly.
my_id
MY_ID
date
Format
Example
Output
Description
xx year
12 years
1 - 2 Years
The range symbol supports - ~. The abbreviation symbols of year and month format support - /.. The year supports 4-digit and 2-digit years.
1998
1998
xx year xx month
April 1998
April 1998
January 2008
January 2008
xx year xx month xx day xx year xx month xx date
August 8, 1998
August 8, 1998
January 1, 2020
January 1, 2020
xx month xx day xx month xx date
August 8th
August 8th
August 1st
August 1st
Abbreviated year and month
2018/08
August 2018
2018.08
Abbreviated year, month and day
2018/08/08
August 8, 2018
2018-8-8
2018.08.08
Abbreviated month and day
08/08
August 8th
08.08
Date
October 1st - 7th
October 1st to 7th
October 1st - October 7th
October 1st to October 7th
October 1st - 7th, 2020
October 1 to 7, 2020
October 1, 2020 - October 7, 2020
October 1st - October 7th, 2020
2020/10/1~2020/10/7
October 1st - 7th, 2020
2020.10.1~2020.10.7
October 1st - October 7th, 2020
October 1st - October 7th, 2020
October 1st - 7th, 2020
2020/10/1~10/7
October 1st - 7th, 2020

time

Format
Example
Output
Moment
12:30
Twelve thirty
10:20:30
Ten twenty thirty
Abbreviated time
5:00am
Five o'clock in the wee hours
10:50AM
Ten fifty in the morning
12:30pm
Noon twelve thirty
6:15PM
Six fifteen in the evening
Time range
10:20~11:20
Ten twenty to eleven twenty
10:20am~3:10pm
Ten twenty in the morning to three ten in the afternoon
10:20:30-11:20:30
Ten twenty thirty to eleven twenty thirty
9:00:12am-5:30:12am
Nine o'clock twelve seconds in the morning to five o'clock thirty seconds twelve seconds in the morning

punctuation

Format
Example
Output
Description
Punctuation
…
ellipsis
Support common Chinese and English punctuation. The space in the output means inserting a pause between each character, that is, reading each character one by one. If the text in the tag contains special characters of XML, perform character escapes.
...
ellipsis
!#$%&
Exclamation point hash dollar percent sign and
‘()*+
Single quotation marks left parenthesis right parenthesis asterisk plus sign
,-./:;
Comma; hyphen; period; slash; colon; semicolon
=?@
= ? at

characters

Format
Example
Output
Description
New Character String
Version No. 2.0
Version No. 2.0
Support Chinese characters, uppercase and lowercase English characters, Arabic numerals 0 - 9, as well as some full-width and half-width characters. The space in the output means inserting a pause between each character, that is, reading each character one by one. If the text in the tag contains special characters of XML, perform character escapes. There are 5 commonly used characters: &lt;, &gt;, &amp;, &quot;, &apos; which correspond to <, >, &, ", ' respectively.
SU M MA000
SU M M A ZERO ZERO ZERO
Airbus A330
Airbus A330
Models S01, S02 and S03
Model S01, S02 and S03
Airbus A330
Airbus A330
αβγ
= ? at alpha beta gamma

measure

Format
Example
Output
Description
Digits + Chinese Units
2 shards
2 shards
Support common Chinese units and their abbreviations
120 hectares
120 hectares
Over 100 milligrams
Over 100 milligrams
About 100 meters
About 100 meters
Over 100 people
Over 100 people
1 centimeter and 20 millimeters
One centimeter and twenty millimeters
120.00 square kilometers
One hundred and twenty point zero zero square kilometers
Digits + Unit Abbreviation
100m
One hundred meters
12cm
Twelve centimeters
6mm
6 millimeters
Scope
10~15kg
Ten to fifteen kg
10.24 to 789.82 mu
Ten point two four to seven hundred and eighty-nine point eight two mu
10 to 15 meters
Ten to fifteen meters
Digits + Unit "/" Unit
10 CNY/jin
10 CNY/jin
199 - 299 CNY/item
199 - 299 CNY/item
Other default pronunciations
12 dozen
Twelve dozen
400 million compatriots
Forty million compatriots
12.897 micrograms
12.897 micrograms

currency

Format
Example
Output
Description
Number + Amount Identifier
12.00RMB
RMB 12.00
Support AUD (Australian Dollar), CAD (Canadian Dollar), HKD (Hong Kong Dollar), JPY (Japanese Yen), USD (US Dollar), CHF (Swiss Franc), NOK (Norwegian Krone), SEK (Swedish Krona), GBP (British Pound), RMB (Renminbi), CNY (Yuan) and EUR (Euro). Supported numeric formats include: integers, decimals, and international writing style separated by commas.
12.50RMB
12.50 RMB
Amount Identifier + Number
$12
Twelve USD
Support CAD (Canadian Dollar), $ (USD), $ (USD), Fr (French Franc), kr (Danish Krone), £ (British Pound), ¥ (CNY), ￥ (CNY) and € (Euro). Supported numeric formats include: integers, decimals, and international writing style separated by commas.
$12.00
12.00 USD
$12.12
2.12 USD
Other default pronunciations
1213
One thousand two hundred and thirteen


Example
<say-as interpret-as="cardinal">-123.01</say-as>, this is a negative number.
<say-as interpret-as="digits">123456</say-as>, this is a string of numbers.
<say-as interpret-as="telephone">18304561111</say-as>, this is a phone number.

<insert-action>

Description
Used to control the anchor to show the specified action at the tag insertion position.
<Tag Relationship>
Empty tag, does not include any tags.
Attribute
Name
Parameter Value
Required or Not
Description
type
Issue enumeration values based on a concrete image
Yes
Action tag content
Example 1
Right hand at the side <insert-action type="right_slide_up"/> sliding upward
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 available.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon