Phonetic symbols

Question type description

• This feature evaluates and scores English phonetic symbols. The response provides a total score, a pronunciation score, and scores for individual phonemes.

Evaluation request parameters

Parameter example

{
    "coreType": "en.alpha.score",
    "refText": "ih",
    "rank": 100,
    "precision": 0.1
}

Sample response

{
  "applicationId": "aXXX",            // The authorized AppKey
    "tokenId": "5a4edc47000df30000090004",  // The unique ID of the request
    "recordId": "5a4edc9d28c338dabd000008",    // The unique ID of the audio file
    "dtLastResponse": "2021-08-09 10:02:08:609",     // The timestamp of the cloud response
    "result": {                       // The evaluation result node
        "forceout": 0,
        "pron": 97.3,    // The pronunciation score, which indicates accuracy.
        "version": "0.0.80.2018.1.3.11:10:55",   // The version of the resource used for the evaluation.
        "rank": 100,
        "pretime": 2,
        "delaytime": 51,   // The time in milliseconds (ms) from when the audio feed ends to when the cloud returns a result.
        "overall": 97.3,   // The total score.
       "info": {
            "tipId": 10006,    // The audio quality. For more information, see the description of the tipId field.
            "clip": 0,         // Audio clipping occurred because the volume was too high. The range is 0 to 1. If this parameter affects the score, a corresponding tipId value is set.
            "snr": 2.888726,   // The signal-to-noise ratio (SNR). A higher value indicates clearer audio. The range is 0 to 40 dB. If this parameter affects the score, a corresponding tipId value is set.	
            "volume": 84       // The recording volume. The range is 0 to 180 dB.
        },
        "wavetime": 1990,     // The audio duration, in ms.
        "systime": 2774,
        "details": [              // Feedback for the phoneme node.
            {
                "dur": 330,     // The pronunciation duration of the phonetic symbol, in ms.
                "phone": [     // The phoneme-level scoring result. The internal phoneme is returned. For more information, see the Phoneme mapping table.
                    {
                        "char": "ih",
                        "score": 97    // The pronunciation score.
                    }
                ],
                "char": "ih",        // The internal phoneme.
                "end": 1030,     // The end time of the phoneme pronunciation, in ms.
                "start": 700,      // The start time of the phoneme pronunciation, in ms.
                "score": 97       // The phoneme score.
            }
        ],
        "precision": 0.1,           // The scoring precision set in the evaluation request. Valid values are 0.1, 0.5, and 1. The default is 1. If you specify an invalid value, the system uses 1.
        "res": "eng.alpha.online.0.1"     // The name of the resource used for the evaluation.
    },
    "eof": 1,
    "params": {
        "app": {            // Internal parameter node. You can ignore this.
            "timestamp": "1515117639",
            "sig": "76f93b03334e890f7fcd683e02b5c8c619d87e97",
            "applicationId": "aXXX",
            "userId": "ssound_text",
            "clientId": ""
        },
        "request": {
            "coreType": "en.alpha.score",
            "tokenId": "5a4edc47000df30000090004",
            "refText": "ih",
            "precision": 0.1,
            "rank": 100
        },
        "audio": {           // The audio parameter node.
            "sampleRate": 16000,     // The sample rate.
            "channel": 1,                  // Mono channel. The evaluation supports only mono audio.
            "sampleBytes": 2,           // The number of bytes per sample. Single-byte and double-byte formats are supported.
            "audioType": "ogg"      // The audio format type.
        }
    },
    "refText": "ih"
}

Response description

Suggestions for displaying evaluation results

Response when evaluation fails

• If the result structure in the response is empty, the evaluation failed.

• The response contains the errId and error fields. Your application can use the error code to determine the next steps.

Error codes

• For more information, see Evaluation error codes.