Poetry
Updated at:
This document provides the technical specifications for the Chinese poetry assessment type. Developers can use this document for product feature integration.
Question type description
This feature supports read-aloud assessments for Chinese poetry and provides feedback on the total score, the score for each sentence, and the score for each character.
Assessment request parameters
Field | Type | Optional | Description |
coreType | String | Required | `cn.poet.score` indicates the Chinese poetry question type. |
refText | String | Required | The reference text for the assessment. |
use_cws | int | Optional | Enables the word segmentation feature for better support of polyphonic characters and numbers. Set to 0 or 1. The default value is 0, which disables this feature. |
feedback | int | Optional | Set to 1 to enable the real-time feedback feature. This feature provides real-time text position information corresponding to the audio being read. The default value is 0, which disables this feature. |
Parameter example
{
"coreType":"cn.poet.score",
"attachAudioUrl":1,
"refText":"In the Bingchen year, during the Mid-Autumn Festival, I drank happily until dawn and became very drunk. I wrote this piece while thinking of my brother, Ziyou. Bright moon, when did you appear? Holding a cup of wine, I ask the blue sky. I wonder, in the palaces of heaven, what year is it tonight. I want to ride the wind and return there, but I fear the crystal towers and jade palaces are too high and cold for me. Dancing with my lonely shadow, it does not seem like the mortal world. The moon rounds the red pavilion, stoops to peep through the silk-draped window, and shines on the sleepless. It should not have resentment. Why does it always become full when people are apart? People have sorrow and joy, separation and reunion. The moon has its phases of dark and bright. Such perfection has been rare since ancient times. May we all live long and share the beauty of the moon, even if we are a thousand miles apart."
}
Response result example
{
"tokenId": "612f4b1488bf5b0000150001",
"applicationId": "a148",
"audioUrl": "http:\/\/files.cloud.ssapi.cn:8080\/a148\/11ec0b08f34b7e8d82f0a148r2611b43",
"connect": {
"param": {
"app": {
"timestamp": "1630489340",
"applicationId": "a148",
"sig": "a065e66a3c38416a03e54440a2d3e4406a5ca98c"
},
"sdk": {
"os": "6.2(9200)1",
"product": "",
"source": 7,
"protocol": 1,
"os_version": "6.2(9200)",
"arch": "586",
"version": 16778752
}
},
"cmd": "connect"
},
"params": {
"app": {
"timestamp": "1630489364",
"userId": "ssound_text",
"sig": "a8228994bf54afa26e1f9636510e5d6306dfa999",
"connect_id": "612f4afc88bf5b0000140002",
"clientId": "",
"applicationId": "a148"
},
"audio": {
"sampleBytes": 2,
"audioType": "ogg",
"sampleRate": 16000,
"channel": 1
},
"request": {
"request_id": "612f4b1488bf5b0000160001",
"tokenId": "612f4b1488bf5b0000150001",
"refText": "In the Bingchen year, during the Mid-Autumn Festival, I drank happily until dawn and became very drunk. I wrote this piece while thinking of my brother, Ziyou. Bright moon, when did you appear? Holding a cup of wine, I ask the blue sky. I wonder, in the palaces of heaven, what year is it tonight. I want to ride the wind and return there, but I fear the crystal towers and jade palaces are too high and cold for me. Dancing with my lonely shadow, it does not seem like the mortal world. The moon rounds the red pavilion, stoops to peep through the silk-draped window, and shines on the sleepless. It should not have resentment. Why does it always become full when people are apart? People have sorrow and joy, separation and reunion. The moon has its phases of dark and bright. Such perfection has been rare since ancient times. May we all live long and share the beauty of the moon, even if we are a thousand miles apart.",
"attachAudioUrl": 1,
"tittleInfo": "Shuidiao Getou, When Will the Bright Moon Appear, Song, Su Shi",
"coreType": "cn.poet.score"
}
},
"recordId": "11ec0b08f34b7e8d82f0a148r2611b43",
"refText": "In the Bingchen year, during the Mid-Autumn Festival, I drank happily until dawn and became very drunk. I wrote this piece while thinking of my brother, Ziyou. Bright moon, when did you appear? Holding a cup of wine, I ask the blue sky. I wonder, in the palaces of heaven, what year is it tonight. I want to ride the wind and return there, but I fear the crystal towers and jade palaces are too high and cold for me. Dancing with my lonely shadow, it does not seem like the mortal world. The moon rounds the red pavilion, stoops to peep through the silk-draped window, and shines on the sleepless. It should not have resentment. Why does it always become full when people are apart? People have sorrow and joy, separation and reunion. The moon has its phases of dark and bright. Such perfection has been rare since ancient times. May we all live long and share the beauty of the moon, even if we are a thousand miles apart.",
"dtLastResponse": "2021-09-01 17:42:45:554",
"cloud_platform": {
"origin_audio_length": 11600
},
"result": {
"version": "0.0.80.2021.8.27.04:29:39",
"pron": 8,
"wavetime": 2990,
"accuracy": 8,
"pretime": 83,
"systime": 3857,
"res": "chn.poet.online.1.0",
"details": [
{
"text": "Bingchen Mid-Autumn",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Bing",
"start": 0,
"char": "bing",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Chen",
"start": 0,
"char": "chen",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Zhong",
"start": 0,
"char": "zhong",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Qiu",
"start": 0,
"char": "qiu",
"score": 0,
"tone": 1,
"end": 0
}
]
},
{
"text": "Drinking happily until dawn",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Huan",
"start": 0,
"char": "huan",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Yin",
"start": 0,
"char": "yin",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Da",
"start": 0,
"char": "da",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Dan",
"start": 0,
"char": "dan",
"score": 0,
"tone": 4,
"end": 0
}
]
},
{
"text": "Very drunk",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Da",
"start": 0,
"char": "da",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Zui",
"start": 0,
"char": "zui",
"score": 0,
"tone": 4,
"end": 0
}
]
},
{
"text": "Wrote this piece",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Zuo",
"start": 0,
"char": "zuo",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Ci",
"start": 0,
"char": "ci",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Pian",
"start": 0,
"char": "pian",
"score": 0,
"tone": 1,
"end": 0
}
]
},
{
"text": "Also thinking of Ziyou",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Jian",
"start": 0,
"char": "jian",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Huai",
"start": 0,
"char": "huai",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Zi",
"start": 0,
"char": "zi",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "You",
"start": 0,
"char": "you",
"score": 0,
"tone": 2,
"end": 0
}
]
},
{
"text": "Bright moon, when did you appear?",
"score": 97,
"fluency": {
"pause": 0,
"overall": 84,
"speed": 1
},
"snt_details": [
{
"char": "ming",
"tonescore": 100,
"dur": 300,
"end": 780,
"chn_char": "Ming",
"score": 99,
"tone": 2,
"start": 480
},
{
"char": "yue",
"tonescore": 100,
"dur": 240,
"end": 1020,
"chn_char": "Yue",
"score": 96,
"tone": 4,
"start": 780
},
{
"char": "ji",
"tonescore": 94,
"dur": 210,
"end": 1230,
"chn_char": "Ji",
"score": 94,
"tone": 3,
"start": 1020
},
{
"char": "shi",
"tonescore": 100,
"dur": 240,
"end": 1470,
"chn_char": "Shi",
"score": 99,
"tone": 2,
"start": 1230
},
{
"char": "you",
"tonescore": 98,
"dur": 210,
"end": 1680,
"chn_char": "You",
"score": 98,
"tone": 3,
"start": 1470
}
]
},
{
"text": "Holding a cup of wine, I ask the blue sky",
"score": 91,
"fluency": {
"pause": 0,
"overall": 83,
"speed": 1
},
"snt_details": [
{
"char": "ba",
"tonescore": 23,
"dur": 180,
"end": 1920,
"chn_char": "Ba",
"score": 72,
"tone": 3,
"start": 1740
},
{
"char": "jiu",
"tonescore": 100,
"dur": 180,
"end": 2100,
"chn_char": "Jiu",
"score": 98,
"tone": 3,
"start": 1920
},
{
"char": "wen",
"tonescore": 99,
"dur": 180,
"end": 2280,
"chn_char": "Wen",
"score": 97,
"tone": 4,
"start": 2100
},
{
"char": "qing",
"tonescore": 84,
"dur": 240,
"end": 2520,
"chn_char": "Qing",
"score": 72,
"tone": 1,
"start": 2280
},
{
"char": "tian",
"tonescore": 100,
"dur": 390,
"end": 2910,
"chn_char": "Tian",
"score": 98,
"tone": 1,
"start": 2520
}
]
},
{
"text": "I wonder, in the palaces of heaven",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Bu",
"start": 0,
"char": "bu",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Zhi",
"start": 0,
"char": "zhi",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Tian",
"start": 0,
"char": "tian",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Shang",
"start": 0,
"char": "shang",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Gong",
"start": 0,
"char": "gong",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Que",
"start": 0,
"char": "que",
"score": 0,
"tone": 1,
"end": 0
}
]
},
{
"text": "What year is it tonight",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Jin",
"start": 0,
"char": "jin",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Xi",
"start": 0,
"char": "xi",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Shi",
"start": 0,
"char": "shi",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "He",
"start": 0,
"char": "he",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Nian",
"start": 0,
"char": "nian",
"score": 0,
"tone": 2,
"end": 0
}
]
},
{
"text": "I want to ride the wind and return there",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Wo",
"start": 0,
"char": "wo",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Yu",
"start": 0,
"char": "yu",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Cheng",
"start": 0,
"char": "cheng",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Feng",
"start": 0,
"char": "feng",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Gui",
"start": 0,
"char": "gui",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Qu",
"start": 0,
"char": "qu",
"score": 0,
"tone": 4,
"end": 0
}
]
},
{
"text": "But I fear the crystal towers and jade palaces",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "You",
"start": 0,
"char": "you",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Kong",
"start": 0,
"char": "kong",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Qiong",
"start": 0,
"char": "qiong",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Lou",
"start": 0,
"char": "lou",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Yu",
"start": 0,
"char": "yu",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Yu",
"start": 0,
"char": "yu",
"score": 0,
"tone": 3,
"end": 0
}
]
},
{
"text": "Are too high and cold for me",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Gao",
"start": 0,
"char": "gao",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Chu",
"start": 0,
"char": "chu",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Bu",
"start": 0,
"char": "bu",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Sheng",
"start": 0,
"char": "sheng",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Han",
"start": 0,
"char": "han",
"score": 0,
"tone": 2,
"end": 0
}
]
},
{
"text": "Dancing with my lonely shadow",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Qi",
"start": 0,
"char": "qi",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Wu",
"start": 0,
"char": "wu",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Nong",
"start": 0,
"char": "long",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Qing",
"start": 0,
"char": "qing",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Ying",
"start": 0,
"char": "ying",
"score": 0,
"tone": 3,
"end": 0
}
]
},
{
"text": "It does not seem like the mortal world",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "He",
"start": 0,
"char": "he",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Si",
"start": 0,
"char": "shi",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Zai",
"start": 0,
"char": "zai",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Ren",
"start": 0,
"char": "ren",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Jian",
"start": 0,
"char": "jian",
"score": 0,
"tone": 1,
"end": 0
}
]
},
{
"text": "Rounds the red pavilion",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Zhuan",
"start": 0,
"char": "zhuai",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Zhu",
"start": 0,
"char": "shu",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Ge",
"start": 0,
"char": "ge",
"score": 0,
"tone": 2,
"end": 0
}
]
},
{
"text": "Stoops to the silk-draped window",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Di",
"start": 0,
"char": "di",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Qi",
"start": 0,
"char": "qi",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Hu",
"start": 0,
"char": "hu",
"score": 0,
"tone": 4,
"end": 0
}
]
},
{
"text": "Shines on the sleepless",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Zhao",
"start": 0,
"char": "zhao",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Wu",
"start": 0,
"char": "wu",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Mian",
"start": 0,
"char": "mian",
"score": 0,
"tone": 2,
"end": 0
}
]
},
{
"text": "Should not have resentment",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Bu",
"start": 0,
"char": "bu",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Ying",
"start": 0,
"char": "ying",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "You",
"start": 0,
"char": "you",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Hen",
"start": 0,
"char": "hen",
"score": 0,
"tone": 4,
"end": 0
}
]
},
{
"text": "Why does it always become full when people are apart?",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "He",
"start": 0,
"char": "he",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Shi",
"start": 0,
"char": "shi",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Chang",
"start": 0,
"char": "chang",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Xiang",
"start": 0,
"char": "xiang",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Bie",
"start": 0,
"char": "bie",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Shi",
"start": 0,
"char": "shi",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Yuan",
"start": 0,
"char": "yuan",
"score": 0,
"tone": 2,
"end": 0
}
]
},
{
"text": "People have sorrow and joy, separation and reunion",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Ren",
"start": 0,
"char": "ren",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "You",
"start": 0,
"char": "you",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Bei",
"start": 0,
"char": "bei",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Huan",
"start": 0,
"char": "huan",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Li",
"start": 0,
"char": "li",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "He",
"start": 0,
"char": "ge",
"score": 0,
"tone": 3,
"end": 0
}
]
},
{
"text": "The moon has its phases of dark and bright",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Yue",
"start": 0,
"char": "yue",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "You",
"start": 0,
"char": "you",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Yin",
"start": 0,
"char": "yin",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Qing",
"start": 0,
"char": "qing",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Yuan",
"start": 0,
"char": "yuan",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Que",
"start": 0,
"char": "que",
"score": 0,
"tone": 1,
"end": 0
}
]
},
{
"text": "This has been rare since ancient times",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Ci",
"start": 0,
"char": "ci",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Shi",
"start": 0,
"char": "shi",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Gu",
"start": 0,
"char": "gu",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Nan",
"start": 0,
"char": "nan",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Quan",
"start": 0,
"char": "quan",
"score": 0,
"tone": 2,
"end": 0
}
]
},
{
"text": "May we all live long",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Dan",
"start": 0,
"char": "dan",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Yuan",
"start": 0,
"char": "yuan",
"score": 0,
"tone": 4,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Ren",
"start": 0,
"char": "ren",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Chang",
"start": 0,
"char": "chang",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Jiu",
"start": 0,
"char": "jiu",
"score": 0,
"tone": 3,
"end": 0
}
]
},
{
"text": "And share the beauty of the moon, though a thousand miles apart",
"score": 0,
"fluency": {
"pause": 0,
"overall": 0,
"speed": 0
},
"snt_details": [
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Qian",
"start": 0,
"char": "qian",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Li",
"start": 0,
"char": "li",
"score": 0,
"tone": 3,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Gong",
"start": 0,
"char": "gong",
"score": 0,
"tone": 1,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Chan",
"start": 0,
"char": "chan",
"score": 0,
"tone": 2,
"end": 0
},
{
"dp_type": 1,
"tonescore": 0,
"dur": 0,
"chn_char": "Juan",
"start": 0,
"char": "juan",
"score": 0,
"tone": 1,
"end": 0
}
]
}
],
"fluency": 84,
"info": {
"tipId": 0,
"clip": 0,
"snr": 10.671018,
"volume": 89
},
"rank": 100,
"delaytime": 93,
"overall": 10,
"integrity": 9,
"tone": 8,
"precision": 1
},
"eof": 1
}Response result description
Key | Type | Description | Recommendation |
recordId | string | The unique ID of the audio file. | For reference. |
tokenId | string | The unique ID of the user request. | For reference. |
audioUrl | string | The download URL for the user's audio. | |
applicationId | string | The authorized assessment account, which is the AppKey. | Internal parameter. |
dtLastResponse | string | The timestamp of the cloud response. | Internal parameter. |
eof | int | 0 indicates that the response is not complete and more results will follow. 1 indicates that all results for this assessment have been returned. | Internal parameter. |
params | object | Echoes the assessment request parameters passed in by the client. | |
- app | object | ||
- - applicationId | string | The authorized assessment account, which is the AppKey. | |
- - userId | string | The user identity. This is a custom string that helps locate and troubleshoot issues. | |
- - timestamp | string | The start time. | |
- - sig | string | The verification code. | |
- - clientId | string | ||
- request | object | The node for scoring request parameters. | |
- audio | object | The node for scoring audio format parameters. | |
result | object | The assessment result. | |
- res | string | The name of the resource used for assessing this question type. | Internal parameter. |
- version | string | The version of the DPI engine, including the release time. | Internal parameter. |
- pretime | int | The time taken by the cloud to call the Start interface, in ms. | Internal parameter. |
- systime | int | The total time taken for the entire assessment procedure, in ms. | Internal parameter. |
- delaytime | int | The time from when the cloud finishes feeding the audio to when the result is obtained, in ms. | Internal parameter. |
- wavetime | int | The duration of the audio, in ms. | For reference. |
- info | object | ||
- - snr | float | The signal-to-noise ratio (SNR). A higher value indicates clearer audio. The range is 0 dB to 40 dB. If this parameter affects the score, a corresponding tipId value is set. | For reference. |
- - clip | float | Indicates audio clipping due to high volume. The range is 0 to 1. If this parameter affects the score, a corresponding tipId value is set. | Internal parameter. |
- - volume | int | The recording volume. The range is 0 dB to 180 dB. | For reference. |
- - tipId | int | Audio quality. For more information, see tipId Message Descriptions. | Recommended field. |
- details | array | Detailed scores for each character. | Recommended field. |
- -fluency | object | Fluency details. | |
- - -pause | int | Indicates if there was a pause. | |
- - -overall | float | The overall fluency score. | |
- - -speed | int | The speech rate. 0: slow, 1: normal, 2: fast. | Reserved for future use. |
- - snt_details | array | Pronunciation score for each character. | Recommended field. |
- - - tone | int | The tone of the character. | |
- - - tonescore | int | The tone score for the character. | |
- - - score | float | The score for the character. | |
- - - char | string | The Pinyin corresponding to the character. | |
- - - chn_char | string | The character. | For reference. |
- - - end | int | Pronunciation duration for a single character, in milliseconds (ms) | |
- - - start | int | The start time of the character in the audio, in milliseconds (ms). | |
- - text | string | The assessed sentence. | |
- - score | float | The score for the sentence. | For reference. |
Recommended dimensions for displaying assessment results
Dimension | Description | Details |
overall | Overall score | The overall score for the pronunciation of the entire sentence. |
pron | Pronunciation score | |
integrity | Integrity | Assesses the completeness of the recorded content compared to the reference sentence. It only evaluates whether the sentence was read completely. |
accuracy | Accuracy | Scores the pronunciation of the content that was read. This is independent of the integrity score. |
fluency.overall | Fluency | Assesses the fluency of the recording. This is independent of the content that was read. |
details[i].score | Sentence score | The score for the pronunciation of each sentence. Perform a null check before retrieving this value. |
details[i].speed | Speech rate | Indicates the speech rate. For more information, see the response description for the corresponding question type. |
details[i]. snt_details[i]. score | Character score | The score for each character in a sentence. |
Response result on assessment failure
If the `result` structure in the response is empty, the assessment has failed. You can retrieve the `errId` and `error` from the response. Use the corresponding error code for subsequent processing.
Error codes
For more information about error codes, see Assessment Error Codes.
Is this page helpful?