/docs
en.sent.score
Kernel Description
Evaluate phrases and sentences, and feedback the total score, fluency score, accuracy score, completeness score, and pronunciation score of each word；
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| coreType | String | true | en.sent.score means English sentence kernel. |
| refText | String | true | The English sentence you want to envalate the recording with. We recommend sentence consisting of 2 to 20 words, such as " I want to know the past and present of Hong Kong. " Accepted text punctuations refer toText Symbol Description。 |
| rank | int | false | 4 or 100, Default value is 100, means full score is 100. |
| result | object | false | Results control parameters |
| - details | object | false | Detailed scoring options |
| - - phone | number | false | Enable to return the phoneme dimension in the evaluation result. Default value is 0. 0: Disable 1: Enable |
Stress, Rising tone, pause（optional）
- Symbols can be used to mark the position of stress tone, rising tone and pause in sentences.
- Accents, ups and downs, and pauses are not counted in the total score.
| Type | Symbols | Sample | Description |
|---|---|---|---|
| Stress | (s:1) | Are(s:1) you ok? | "Are" is maked with stressed. |
| Rising tone | (t:1) | Are you ok(t:1)? | "Ok" is marked with rising tone. |
| Both Stress and rising tone | (s:1,t:1) | Are you ok(s:1,t:1)? | Word “ok” is marked as both stress and rising tone, use commas to separate marks. |
| Pause | (g:1) | Are you(g:1) ok? | Word “you” is marked with pause. |
Sample Code
{
"coreType": "en.sent.score",
"refText": " I want to know the past and present of Hong Kong.",
"rank": 100
}
Example of Returned Results
- The results are returned using the JSON structure,Example
Introduction to Returned Results
| Key | Type | Description | Recommendations |
|---|---|---|---|
| tokenId | string | Unique identification of evaluation data | For reference |
| result | object | Scoring result | |
| - wavetime | number | Audio duration (Unit:milliseconds) | For reference |
| - overall | number | Overall score1. If the results are returned normally, please refer to evaluation results display suggestion2. If the result is empty, it means the evaluation is abnormal, please refer to error code | Suggest to display |
| - accuracy | number | Score of accuracy(pronunciation evaluation of the read part). | Suggest to display |
| - integrity | number | Score of integrity. | Suggest to display |
| - fluency | object | Fluency score details | |
| - - overall | number | Overall score of fluency | Suggest to display |
| - - pause | number | Number of pauses. | Suggest to display |
| - - speed | number | Speech rate, which is the number of words read per minute. | Suggest to display |
| - details | array | Words and phoneme scores | |
| - - char | string | Word | Suggest to display |
| - - score | number | Word pronunciation score | Suggest to display |
| - - indict | int | Whether the word's pronunciation is in dictionary. 0 or 1 0: The word is not in Chivox’s dictionary. 1: The word is in Chivox’s dictionary. |
For reference |
| - - start | number | The start time of the word in audio (Unit:milliseconds). | For reference |
| - - end | number | The end time of the word in audio (Unit: milliseconds). | For reference |
| - - beginindex | number | The word first letter's index | Suggest to display |
| - - endindex | number | The word last letter's index. | Suggest to display |
| - - stressref | number | 0 or 1: 0: Not marked to be stressed. 1: Marked to be stressed. |
Suggest to display |
| - - stressscore | number | 0 or 1: 0: Not stressed in audio. 1: Stressed in audio. stressscore=stressref，Indicates that the pronunciation is consistent with the mark |
Suggest to display |
| - - toneref | number | 0 or 1: 0: Not marked to rising tone. 1: Marked to rising tone. |
Suggest to display |
| - - tonescore | number | 0 or 1: 0: Not reading with rising tone. 1: Reading with rising tone. tonescore=toneref， Indicates that the rising and falling tone pronunciation and the mark in the text match |
Suggest to display |
| - - senseref | number | 0 or 1: 0: Not marked to pause. 1: Marked to pause. |
Suggest to display |
| - - sensescore | number | 0 or 1: 0: Reading without pause after the word. 1: Reading with pause after the word. sensescore=senseref， Indicates that the pause detection and the mark in the text match |
Suggest to display |
| - - phone | array | honeme-level scoring results. Refer toPhonetic Comparison Table |
|
| - - -char | string | Phoneme | For reference |
| - - -score | number | Phoneme score | For reference |
Note: The other returned parameters that are not shown above are internal ones, which you don't need to pay much atttention to.