Score Text/Fluency

Run in Postman: Score Fluency

Fluency and Pronunciation are scored based on a speaker reading aloud a passage for up to The request parameters which you can see in the cURL below are the same as in the Score Text/Pronunciation function. Please review below sections on making a simple CURL based request to the fluency scoring function:

curl --location -g 'https://api.speechace.co/api/scoring/text/v9/json?key={{speechace_prokey}}&dialect=en-us' \
--form 'text="Yes, I do. Travel today is vastly different than what it used to be. In the past, a traveller had little idea about what to expect when they arrived at their destination. These days, the internet connects our world in ways previous generations could only dream about. We can instantly review destination information and make travel arrangements. Also, in the past, people could only travel by land or sea and travelling was often long and unsafe."' \
--form 'user_audio_file=@"./traveltoday.wav"' \
--form 'include_fluency="1"'

The responses below show a correct response, and a response where the speaker doesn't read the complete passage and as a result triggers fidelity detection.

Fidelity detection identifies when the test-taker deviates from intended utterance and API detects incomplete or off-script attempts.

{
  "status": "success",
  "quota_remaining": -1,
  "text_score": {
    "text": "Yes, I do. Travel today is vastly different than what it used to be. In the past, a traveller had little idea about what to expect when they arrived at their destination. These days, the internet connects our world in ways previous generations could only dream about. We can instantly review destination information and make travel arrangements. Also, in the past, people could only travel by land or sea and travelling was often long and unsafe.",
    "word_score_list": [<...word scores for the words in the utterance>],
    "ielts_score": {<...ielts score>},
    "pte_score": {<...pte score>},
    "speechace_score": {<...speechace scores>},
    "toeic_score": {<...toeic scores>},
    "cefr_score": {<...cefr scores>},
    "fluency": {
      "segment_metrics_list": [
        {
          "segment": [
            0,
            3
          ],
          "duration": 1.005,
          "articulation_length": 0.69,
          "syllable_count": 3,
          "correct_syllable_count": 3,
          "correct_word_count": 3,
          "word_count": 3,
          "speech_rate": 2.985074626865672,
          "articulation_rate": 4.347826086956522,
          "syllable_correct_per_minute": 179.10447761194033,
          "word_correct_per_minute": 179.10447761194033,
          "all_pause_count": 1,
          "all_pause_duration": 0.315,
          "mean_length_run": 0.69,
          "max_length_run": 0.69,
          "all_pause_list": [
            [
              144,
              175.5
            ]
          ],
          "ielts_score": {
            "pronunciation": 9,
            "fluency": 8.5
          },
          "pte_score": {
            "pronunciation": 90,
            "fluency": 90
          },
          "speechace_score": {
            "pronunciation": 100,
            "fluency": 93
          },
          "toeic_score": {
            "pronunciation": 200,
            "fluency": 190
          },
          "cefr_score": {
            "pronunciation": "C2",
            "fluency": "C2"
          }
        },
        {
          "segment": [
            3,
            14
          ],
          "duration": 3.525,
          "articulation_length": 2.82,
          "syllable_count": 15,
          "correct_syllable_count": 14,
          "correct_word_count": 11,
          "word_count": 11,
          "speech_rate": 4.25531914893617,
          "articulation_rate": 5.319148936170213,
          "syllable_correct_per_minute": 238.29787234042553,
          "word_correct_per_minute": 187.2340425531915,
          "all_pause_count": 2,
          "all_pause_duration": 0.705,
          "mean_length_run": 2.82,
          "max_length_run": 2.82,
          "all_pause_list": [
            [
              175.5,
              207
            ],
            [
              489,
              528
            ]
          ],
          "ielts_score": {
            "pronunciation": 8.5,
            "fluency": 8
          },
          "pte_score": {
            "pronunciation": 90,
            "fluency": 88
          },
          "speechace_score": {
            "pronunciation": 95,
            "fluency": 91
          },
          "toeic_score": {
            "pronunciation": 190,
            "fluency": 180
          },
          "cefr_score": {
            "pronunciation": "C2",
            "fluency": "C1+"
          }
        },
        {
          "segment": [
            14,
            32
          ],
          "duration": 5.205,
          "articulation_length": 4.52,
          "syllable_count": 29,
          "correct_syllable_count": 25,
          "correct_word_count": 15,
          "word_count": 18,
          "speech_rate": 5.571565802113352,
          "articulation_rate": 6.415929203539823,
          "syllable_correct_per_minute": 288.1844380403458,
          "word_correct_per_minute": 172.9106628242075,
          "all_pause_count": 3,
          "all_pause_duration": 0.685,
          "mean_length_run": 2.26,
          "max_length_run": 3.95,
          "all_pause_list": [
            [
              528,
              567
            ],
            [
              624,
              625
            ],
            [
              1020,
              1048.5
            ]
          ],
          "ielts_score": {
            "pronunciation": 8.5,
            "fluency": 7.5
          },
          "pte_score": {
            "pronunciation": 89,
            "fluency": 74
          },
          "speechace_score": {
            "pronunciation": 92,
            "fluency": 82
          },
          "toeic_score": {
            "pronunciation": 190,
            "fluency": 170
          },
          "cefr_score": {
            "pronunciation": "C2",
            "fluency": "C1"
          }
        },
        {
          "segment": [
            32,
            47
          ],
          "duration": 6.045,
          "articulation_length": 4.92,
          "syllable_count": 25,
          "correct_syllable_count": 22,
          "correct_word_count": 13,
          "word_count": 15,
          "speech_rate": 4.1356492969396195,
          "articulation_rate": 5.08130081300813,
          "syllable_correct_per_minute": 218.36228287841192,
          "word_correct_per_minute": 129.03225806451613,
          "all_pause_count": 3,
          "all_pause_duration": 1.125,
          "mean_length_run": 2.46,
          "max_length_run": 2.85,
          "all_pause_list": [
            [
              1048.5,
              1077
            ],
            [
              1362,
              1422
            ],
            [
              1629,
              1653
            ]
          ],
          "ielts_score": {
            "pronunciation": 8.5,
            "fluency": 8
          },
          "pte_score": {
            "pronunciation": 89,
            "fluency": 86
          },
          "speechace_score": {
            "pronunciation": 92,
            "fluency": 90
          },
          "toeic_score": {
            "pronunciation": 190,
            "fluency": 180
          },
          "cefr_score": {
            "pronunciation": "C2",
            "fluency": "C1+"
          }
        },
        {
          "segment": [
            47,
            57
          ],
          "duration": 4.05,
          "articulation_length": 3.63,
          "syllable_count": 22,
          "correct_syllable_count": 18,
          "correct_word_count": 9,
          "word_count": 10,
          "speech_rate": 5.432098765432099,
          "articulation_rate": 6.0606060606060606,
          "syllable_correct_per_minute": 266.6666666666667,
          "word_correct_per_minute": 133.33333333333334,
          "all_pause_count": 2,
          "all_pause_duration": 0.42,
          "mean_length_run": 3.63,
          "max_length_run": 3.63,
          "all_pause_list": [
            [
              1653,
              1677
            ],
            [
              2040,
              2058
            ]
          ],
          "ielts_score": {
            "pronunciation": 8.5,
            "fluency": 7
          },
          "pte_score": {
            "pronunciation": 90,
            "fluency": 66
          },
          "speechace_score": {
            "pronunciation": 93,
            "fluency": 77
          },
          "toeic_score": {
            "pronunciation": 190,
            "fluency": 160
          },
          "cefr_score": {
            "pronunciation": "C2",
            "fluency": "B2"
          }
        },
        {
          "segment": [
            57,
            76
          ],
          "duration": 5.76,
          "articulation_length": 5.16,
          "syllable_count": 26,
          "correct_syllable_count": 23,
          "correct_word_count": 16,
          "word_count": 19,
          "speech_rate": 4.513888888888889,
          "articulation_rate": 5.038759689922481,
          "syllable_correct_per_minute": 239.58333333333334,
          "word_correct_per_minute": 166.66666666666669,
          "all_pause_count": 2,
          "all_pause_duration": 0.6,
          "mean_length_run": 2.58,
          "max_length_run": 2.85,
          "all_pause_list": [
            [
              2058,
              2076
            ],
            [
              2361,
              2403
            ]
          ],
          "ielts_score": {
            "pronunciation": 8.5,
            "fluency": 8.5
          },
          "pte_score": {
            "pronunciation": 90,
            "fluency": 90
          },
          "speechace_score": {
            "pronunciation": 95,
            "fluency": 92
          },
          "toeic_score": {
            "pronunciation": 190,
            "fluency": 190
          },
          "cefr_score": {
            "pronunciation": "C2",
            "fluency": "C2"
          }
        }
      ],
      "overall_metrics": {
        "segment": [
          0,
          76
        ],
        "duration": 25.59,
        "articulation_length": 21.74,
        "syllable_count": 120,
        "correct_syllable_count": 105,
        "correct_word_count": 67,
        "word_count": 76,
        "speech_rate": 4.6893317702227435,
        "articulation_rate": 5.519779208831647,
        "syllable_correct_per_minute": 246.18991793669403,
        "word_correct_per_minute": 157.0926143024619,
        "all_pause_count": 8,
        "all_pause_duration": 3.85,
        "mean_length_run": 2.4155555555555552,
        "max_length_run": 3.95,
        "all_pause_list": [
          [
            144,
            207
          ],
          [
            489,
            567
          ],
          [
            624,
            625
          ],
          [
            1020,
            1077
          ],
          [
            1362,
            1422
          ],
          [
            1629,
            1677
          ],
          [
            2040,
            2076
          ],
          [
            2361,
            2403
          ]
        ]
      },
      "fluency_version": null
    }
  },
  "version": "9.8"
}
    

Last updated