Score Text/Pronunciation
Run in Postman: Score a word or sentence
Request Format
The endpoint that is to be used will depend on the region of your subscription. For example, for US West, the endpoint is https://api.speechace.co.
POST https://api.speechace.co/api/scoring/text/v9/json
curl --location -g 'https://api.speechace.co/api/scoring/text/v9/json?key={{speechacekey}}&dialect=en-us \
--form 'text="apple"' \
--form 'user_audio_file=@"apple.wav"'curl --location -g 'https://api.speechace.co/api/scoring/text/v9/json?key={{speechacekey}}&dialect=en-us \
--form 'text="Some parents admire famous athletes as strong role models, so they name their children after them."' \
--form 'user_audio_file=@"someparents.wav"'Query Parameters
| Parameter | Type | Description |
|---|---|---|
key | String | API key issued by Speechace. |
dialect | String | This is the dialect in which the speaker will be assessed. Note: Not all features of the score/text API support every dialect. Applicable dialects will be explicitly mentioned. |
user_id | String | Optional: A unique anonymized identifier (generated by your application) for the end-user who spoke the audio. |
Request Body
| Parameter | Type | Description |
|---|---|---|
text | String | A word, phrase, or sentence to score. This should be in the dialect chosen. For example, if |
user_audio_file | File | file with user audio (wav, mp3, m4a, webm, ogg, aiff) |
question_info | String | Optional: A unique identifier (generated by your application) for the activity or question this user audio is answering. |
no_mc | String | Optional: |
include_fluency | String | Optional: |
include_intonation | String | Optional: |
markup_language | String | Optional: See this guide for how to use this field. |
include_unknown_words | String | Optional: This key instructs Speechace to automatically infer the expected pronunciation for unknown terms, such as names, places, and other specific terminology. This ensures accurate feedback even for unfamiliar words. |
Response Example
{
"status": "success",
"quota_remaining": -1,
"text_score": {
"text": "apple",
"word_score_list": [
{
"word": "apple",
"quality_score": 100,
"phone_score_list": [
{
"phone": "ae",
"stress_level": 1,
"extent": [
12,
27
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 2,
"word_extent": [
0,
1
],
"sound_most_like": "ae"
},
{
"phone": "p",
"stress_level": null,
"extent": [
27,
39
],
"quality_score": 100,
"word_extent": [
2,
3
],
"sound_most_like": "p"
},
{
"phone": "ah",
"stress_level": 0,
"extent": [
39,
42
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 0,
"word_extent": [
3,
4
],
"sound_most_like": "ah"
},
{
"phone": "l",
"stress_level": null,
"extent": [
42,
54
],
"quality_score": 98.5,
"word_extent": [
3,
4
],
"sound_most_like": "l"
}
],
"syllable_score_list": [
{
"phone_count": 1,
"stress_level": 1,
"letters": "ap",
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 2,
"extent": [
12,
27
]
},
{
"phone_count": 3,
"stress_level": 0,
"letters": "ple",
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 0,
"extent": [
27,
54
]
}
]
}
],
"ielts_score": {
"pronunciation": 9
},
"pte_score": {
"pronunciation": 90
},
"speechace_score": {
"pronunciation": 100
},
"toeic_score": {
"pronunciation": 200
},
"cefr_score": {
"pronunciation": "C2"
}
},
"version": "9.3"
}{
"status": "success",
"quota_remaining": -1,
"text_score": {
"text": "Some parents admire famous athletes as strong role models, so they name their children after them.",
"word_score_list": [
{
"word": "Some",
"quality_score": 99,
"phone_score_list": [
{
"phone": "s",
"stress_level": null,
"extent": [
9,
27
],
"quality_score": 98.66666666666667,
"word_extent": [
0,
1
],
"sound_most_like": "s"
},
{
"phone": "ah",
"stress_level": 1,
"extent": [
27,
36
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
1,
2
],
"sound_most_like": "ah"
},
{
"phone": "m",
"stress_level": null,
"extent": [
36,
42
],
"quality_score": 99.5,
"word_extent": [
2,
3
],
"sound_most_like": "m"
}
],
"syllable_score_list": [
{
"phone_count": 3,
"stress_level": 1,
"letters": "some",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
9,
42
]
}
]
},
{
"word": "parents",
"quality_score": 99,
"phone_score_list": [
{
"phone": "p",
"stress_level": null,
"extent": [
42,
51
],
"quality_score": 100,
"word_extent": [
0,
1
],
"sound_most_like": "p"
},
{
"phone": "eh",
"stress_level": 1,
"extent": [
51,
57
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
1,
2
],
"sound_most_like": "eh"
},
{
"phone": "r",
"stress_level": null,
"extent": [
57,
66
],
"quality_score": 100,
"word_extent": [
2,
3
],
"sound_most_like": "r"
},
{
"phone": "ah",
"stress_level": 0,
"extent": [
66,
69
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 0,
"word_extent": [
3,
4
],
"sound_most_like": "ah"
},
{
"phone": "n",
"stress_level": null,
"extent": [
69,
75
],
"quality_score": 100,
"word_extent": [
4,
5
],
"sound_most_like": "n"
},
{
"phone": "t",
"stress_level": null,
"extent": [
75,
76
],
"quality_score": 94,
"word_extent": [
5,
6
],
"sound_most_like": "t"
},
{
"phone": "s",
"stress_level": null,
"extent": [
76,
84
],
"quality_score": 99.25,
"word_extent": [
6,
7
],
"sound_most_like": "s"
}
],
"syllable_score_list": [
{
"phone_count": 2,
"stress_level": 1,
"letters": "pa",
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
42,
57
]
},
{
"phone_count": 5,
"stress_level": 0,
"letters": "rents",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 0,
"extent": [
57,
84
]
}
]
},
{
"word": "admire",
"quality_score": 99,
"phone_score_list": [
{
"phone": "ah",
"stress_level": 0,
"extent": [
84,
90
],
"quality_score": 97,
"stress_score": 100,
"predicted_stress_level": 0,
"word_extent": [
0,
1
],
"sound_most_like": "ah"
},
{
"phone": "d",
"stress_level": null,
"extent": [
90,
93
],
"quality_score": 100,
"word_extent": [
1,
2
],
"sound_most_like": "d"
},
{
"phone": "m",
"stress_level": null,
"extent": [
93,
102
],
"quality_score": 100,
"word_extent": [
2,
3
],
"sound_most_like": "m"
},
{
"phone": "ay",
"stress_level": 1,
"extent": [
102,
117
],
"quality_score": 99.8,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
3,
4
],
"sound_most_like": "ay"
},
{
"phone": "er",
"stress_level": 0,
"extent": [
117,
129
],
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 0,
"word_extent": [
4,
5
],
"sound_most_like": "er"
}
],
"syllable_score_list": [
{
"phone_count": 2,
"stress_level": 0,
"letters": "ad",
"quality_score": 98,
"stress_score": 100,
"predicted_stress_level": 0,
"extent": [
84,
93
]
},
{
"phone_count": 2,
"stress_level": 1,
"letters": "mi",
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
93,
117
]
},
{
"phone_count": 1,
"stress_level": 0,
"letters": "re",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 0,
"extent": [
117,
129
]
}
]
},
{
"word": "famous",
"quality_score": 98,
"phone_score_list": [
{
"phone": "f",
"stress_level": null,
"extent": [
129,
141
],
"quality_score": 98.75,
"word_extent": [
0,
1
],
"sound_most_like": "f"
},
{
"phone": "ey",
"stress_level": 1,
"extent": [
141,
150
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
1,
2
],
"sound_most_like": "ey"
},
{
"phone": "m",
"stress_level": null,
"extent": [
150,
156
],
"quality_score": 100,
"word_extent": [
2,
3
],
"sound_most_like": "m"
},
{
"phone": "ah",
"stress_level": 0,
"extent": [
156,
162
],
"quality_score": 95.5,
"stress_score": 100,
"predicted_stress_level": 0,
"word_extent": [
3,
5
],
"sound_most_like": "ah"
},
{
"phone": "s",
"stress_level": null,
"extent": [
162,
174
],
"quality_score": 95.5,
"word_extent": [
5,
6
],
"sound_most_like": "s"
}
],
"syllable_score_list": [
{
"phone_count": 2,
"stress_level": 1,
"letters": "fa",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
129,
150
]
},
{
"phone_count": 3,
"stress_level": 0,
"letters": "mous",
"quality_score": 97,
"stress_score": 100,
"predicted_stress_level": 0,
"extent": [
150,
174
]
}
]
},
{
"word": "athletes",
"quality_score": 98,
"phone_score_list": [
{
"phone": "ae",
"stress_level": 1,
"extent": [
174,
186
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
0,
1
],
"sound_most_like": "ae"
},
{
"phone": "th",
"stress_level": null,
"extent": [
186,
195
],
"quality_score": 96.66666666666667,
"word_extent": [
1,
3
],
"sound_most_like": "th"
},
{
"phone": "l",
"stress_level": null,
"extent": [
195,
204
],
"quality_score": 99.66666666666667,
"word_extent": [
3,
4
],
"sound_most_like": "l"
},
{
"phone": "iy",
"stress_level": 2,
"extent": [
204,
213
],
"quality_score": 99.66666666666667,
"stress_score": 50,
"predicted_stress_level": 0,
"word_extent": [
4,
5
],
"sound_most_like": "iy"
},
{
"phone": "t",
"stress_level": null,
"extent": [
213,
219
],
"quality_score": 97.5,
"word_extent": [
5,
6
],
"sound_most_like": "t"
},
{
"phone": "s",
"stress_level": null,
"extent": [
219,
225
],
"quality_score": 93,
"word_extent": [
7,
8
],
"sound_most_like": "s"
}
],
"syllable_score_list": [
{
"phone_count": 2,
"stress_level": 1,
"letters": "ath",
"quality_score": 98,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
174,
195
]
},
{
"phone_count": 4,
"stress_level": 2,
"letters": "letes",
"quality_score": 97,
"stress_score": 50,
"predicted_stress_level": 0,
"extent": [
195,
225
]
}
]
},
{
"word": "as",
"quality_score": 100,
"phone_score_list": [
{
"phone": "eh",
"stress_level": 1,
"extent": [
225,
234
],
"quality_score": 99.66666666666667,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
0,
1
],
"sound_most_like": "eh"
},
{
"phone": "z",
"stress_level": null,
"extent": [
234,
240
],
"quality_score": 100,
"word_extent": [
1,
2
],
"sound_most_like": "z"
}
],
"syllable_score_list": [
{
"phone_count": 2,
"stress_level": 1,
"letters": "as",
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
225,
240
]
}
]
},
{
"word": "strong",
"quality_score": 100,
"phone_score_list": [
{
"phone": "s",
"stress_level": null,
"extent": [
240,
246
],
"quality_score": 100,
"word_extent": [
0,
1
],
"sound_most_like": "s"
},
{
"phone": "t",
"stress_level": null,
"extent": [
246,
252
],
"quality_score": 100,
"word_extent": [
1,
2
],
"sound_most_like": "t"
},
{
"phone": "r",
"stress_level": null,
"extent": [
252,
258
],
"quality_score": 100,
"word_extent": [
2,
3
],
"sound_most_like": "r"
},
{
"phone": "ao",
"stress_level": 1,
"extent": [
258,
267
],
"quality_score": 99.33333333333333,
"stress_score": 100,
"predicted_stress_level": 0,
"word_extent": [
3,
4
],
"sound_most_like": "ao"
},
{
"phone": "ng",
"stress_level": null,
"extent": [
267,
273
],
"quality_score": 100,
"word_extent": [
4,
6
],
"sound_most_like": "ng"
}
],
"syllable_score_list": [
{
"phone_count": 5,
"stress_level": 1,
"letters": "strong",
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 0,
"extent": [
240,
273
]
}
]
},
{
"word": "role",
"quality_score": 100,
"phone_score_list": [
{
"phone": "r",
"stress_level": null,
"extent": [
273,
282
],
"quality_score": 99.66666666666667,
"word_extent": [
0,
1
],
"sound_most_like": "r"
},
{
"phone": "ow",
"stress_level": 1,
"extent": [
282,
291
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
1,
2
],
"sound_most_like": "ow"
},
{
"phone": "l",
"stress_level": null,
"extent": [
291,
300
],
"quality_score": 100,
"word_extent": [
2,
3
],
"sound_most_like": "l"
}
],
"syllable_score_list": [
{
"phone_count": 3,
"stress_level": 1,
"letters": "role",
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
273,
300
]
}
]
},
{
"word": "models",
"quality_score": 99,
"phone_score_list": [
{
"phone": "m",
"stress_level": null,
"extent": [
300,
312
],
"quality_score": 98.25,
"word_extent": [
0,
1
],
"sound_most_like": "m"
},
{
"phone": "aa",
"stress_level": 1,
"extent": [
312,
321
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
1,
2
],
"sound_most_like": "aa"
},
{
"phone": "d",
"stress_level": null,
"extent": [
321,
327
],
"quality_score": 100,
"word_extent": [
2,
3
],
"sound_most_like": "d"
},
{
"phone": "ah",
"stress_level": 0,
"extent": [
327,
333
],
"quality_score": 96,
"stress_score": 100,
"predicted_stress_level": 0,
"word_extent": [
3,
4
],
"sound_most_like": "ah"
},
{
"phone": "l",
"stress_level": null,
"extent": [
333,
339
],
"quality_score": 100,
"word_extent": [
4,
5
],
"sound_most_like": "l"
},
{
"phone": "z",
"stress_level": null,
"extent": [
339,
354
],
"quality_score": 100,
"word_extent": [
5,
6
],
"sound_most_like": "z"
}
],
"ending_punctuation": ",",
"syllable_score_list": [
{
"phone_count": 2,
"stress_level": 1,
"letters": "mo",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
300,
321
]
},
{
"phone_count": 4,
"stress_level": 0,
"letters": "dels",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 0,
"extent": [
321,
354
]
}
]
},
{
"word": "so",
"quality_score": 99,
"phone_score_list": [
{
"phone": "s",
"stress_level": null,
"extent": [
390,
408
],
"quality_score": 99.33333333333333,
"word_extent": [
0,
1
],
"sound_most_like": "s"
},
{
"phone": "ow",
"stress_level": 1,
"extent": [
408,
414
],
"quality_score": 99.5,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
1,
2
],
"sound_most_like": "ow"
}
],
"syllable_score_list": [
{
"phone_count": 2,
"stress_level": 1,
"letters": "so",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
390,
414
]
}
]
},
{
"word": "they",
"quality_score": 99,
"phone_score_list": [
{
"phone": "dh",
"stress_level": null,
"extent": [
414,
420
],
"quality_score": 100,
"word_extent": [
0,
2
],
"sound_most_like": "dh"
},
{
"phone": "ey",
"stress_level": 1,
"extent": [
420,
429
],
"quality_score": 98.33333333333333,
"stress_score": 100,
"predicted_stress_level": 0,
"word_extent": [
2,
4
],
"sound_most_like": "ey"
}
],
"syllable_score_list": [
{
"phone_count": 2,
"stress_level": 1,
"letters": "they",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 0,
"extent": [
414,
429
]
}
]
},
{
"word": "name",
"quality_score": 99,
"phone_score_list": [
{
"phone": "n",
"stress_level": null,
"extent": [
429,
435
],
"quality_score": 100,
"word_extent": [
0,
1
],
"sound_most_like": "n"
},
{
"phone": "ey",
"stress_level": 1,
"extent": [
435,
444
],
"quality_score": 99.66666666666667,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
1,
2
],
"sound_most_like": "ey"
},
{
"phone": "m",
"stress_level": null,
"extent": [
444,
453
],
"quality_score": 98,
"word_extent": [
2,
3
],
"sound_most_like": "m"
}
],
"syllable_score_list": [
{
"phone_count": 3,
"stress_level": 1,
"letters": "name",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
429,
453
]
}
]
},
{
"word": "their",
"quality_score": 99,
"phone_score_list": [
{
"phone": "dh",
"stress_level": null,
"extent": [
453,
459
],
"quality_score": 100,
"word_extent": [
0,
2
],
"sound_most_like": "dh"
},
{
"phone": "eh",
"stress_level": 1,
"extent": [
459,
465
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
2,
3
],
"sound_most_like": "eh"
},
{
"phone": "r",
"stress_level": null,
"extent": [
465,
468
],
"quality_score": 96,
"word_extent": [
4,
5
],
"sound_most_like": "r"
}
],
"syllable_score_list": [
{
"phone_count": 3,
"stress_level": 1,
"letters": "their",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
453,
468
]
}
]
},
{
"word": "children",
"quality_score": 98,
"phone_score_list": [
{
"phone": "ch",
"stress_level": null,
"extent": [
468,
483
],
"quality_score": 97.6,
"word_extent": [
0,
2
],
"sound_most_like": "ch"
},
{
"phone": "ih",
"stress_level": 1,
"extent": [
483,
489
],
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
2,
3
],
"sound_most_like": "ih"
},
{
"phone": "l",
"stress_level": null,
"extent": [
489,
495
],
"quality_score": 100,
"word_extent": [
3,
4
],
"sound_most_like": "l"
},
{
"phone": "d",
"stress_level": null,
"extent": [
495,
498
],
"quality_score": 100,
"word_extent": [
4,
5
],
"sound_most_like": "d"
},
{
"phone": "r",
"stress_level": null,
"extent": [
498,
507
],
"quality_score": 95.66666666666667,
"word_extent": [
5,
6
],
"sound_most_like": "r"
},
{
"phone": "ah",
"stress_level": 0,
"extent": [
507,
510
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 0,
"word_extent": [
6,
7
],
"sound_most_like": "ah"
},
{
"phone": "n",
"stress_level": null,
"extent": [
510,
519
],
"quality_score": 96.66666666666667,
"word_extent": [
7,
8
],
"sound_most_like": "n"
}
],
"syllable_score_list": [
{
"phone_count": 3,
"stress_level": 1,
"letters": "chil",
"quality_score": 99,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
468,
495
]
},
{
"phone_count": 4,
"stress_level": 0,
"letters": "dren",
"quality_score": 98,
"stress_score": 100,
"predicted_stress_level": 0,
"extent": [
495,
519
]
}
]
},
{
"word": "after",
"quality_score": 100,
"phone_score_list": [
{
"phone": "ae",
"stress_level": 1,
"extent": [
519,
531
],
"quality_score": 99.75,
"stress_score": 100,
"predicted_stress_level": 2,
"word_extent": [
0,
1
],
"sound_most_like": "ae"
},
{
"phone": "f",
"stress_level": null,
"extent": [
531,
540
],
"quality_score": 100,
"word_extent": [
1,
2
],
"sound_most_like": "f"
},
{
"phone": "t",
"stress_level": null,
"extent": [
540,
546
],
"quality_score": 100,
"word_extent": [
2,
3
],
"sound_most_like": "t"
},
{
"phone": "er",
"stress_level": 0,
"extent": [
546,
549
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 0,
"word_extent": [
3,
5
],
"sound_most_like": "er"
}
],
"syllable_score_list": [
{
"phone_count": 2,
"stress_level": 1,
"letters": "af",
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 2,
"extent": [
519,
540
]
},
{
"phone_count": 2,
"stress_level": 0,
"letters": "ter",
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 0,
"extent": [
540,
549
]
}
]
},
{
"word": "them",
"quality_score": 100,
"phone_score_list": [
{
"phone": "dh",
"stress_level": null,
"extent": [
549,
555
],
"quality_score": 100,
"word_extent": [
0,
2
],
"sound_most_like": "dh"
},
{
"phone": "eh",
"stress_level": 1,
"extent": [
555,
564
],
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"word_extent": [
2,
3
],
"sound_most_like": "eh"
},
{
"phone": "m",
"stress_level": null,
"extent": [
564,
582
],
"quality_score": 100,
"word_extent": [
3,
4
],
"sound_most_like": "m"
}
],
"ending_punctuation": ".",
"syllable_score_list": [
{
"phone_count": 3,
"stress_level": 1,
"letters": "them",
"quality_score": 100,
"stress_score": 100,
"predicted_stress_level": 1,
"extent": [
549,
582
]
}
]
}
],
"ielts_score": {
"pronunciation": 9
},
"pte_score": {
"pronunciation": 90
},
"speechace_score": {
"pronunciation": 99
},
"toeic_score": {
"pronunciation": 200
},
"cefr_score": {
"pronunciation": "C2"
}
},
"version": "9.3"
}Last updated