QuerySpeechLanguageModel
The QuerySpeechLanguageModel action takes one or more words and returns whether those words are present in the vocabulary (produced from a combination of a base language pack and an optional custom language model).
If a word is not present in the vocabulary then it is never returned during speech-to-text, and you might be able to improve accuracy by training a custom language model.
Type: synchronous
| Parameter | Description | Required |
|---|---|---|
CustomLanguageModel
|
The name and interpolation weight of a custom language model to use to supplement the base language pack. Separate the name and interpolation weight with a colon (:). |
No |
LanguagePack
|
The base language pack. | Yes |
Words
|
A comma-separated list of words to test. | Yes |
Example
The following example checks whether the words magnetic, resonance, and imaging are in the vocabulary when you use the ENUS language pack and a custom language model named MedicalTerms with an interpolation weight of 0.1.
/action=QuerySpeechLanguageModel&LanguagePack=ENUS
&CustomLanguageModel=MedicalTerms:0.1
&Words=magnetic,resonance,imaging
Response
The following XML is an example response.
<autnresponse>
<action>QUERYSPEECHLANGUAGEMODEL</action>
<response>SUCCESS</response>
<responsedata>
<queryWord>
<word>magnetic</word>
<exists>True</exists>
<rankPercentile>82</rankPercentile>
<occurrencesPerMillion>4.9</occurrencesPerMillion>
</queryWord>
<queryWord>
<word>resonance</word>
<exists>True</exists>
<rankPercentile>64</rankPercentile>
<occurrencesPerMillion>1.7</occurrencesPerMillion>
</queryWord>
...
</responsedata>
</autnresponse>
The response includes a queryWord element for each of the input words.
- The
existselement specifies whether the word exists in the vocabulary. If this element has a value offalseyou might be able to improve the speech-to-text accuracy by training a custom language model that includes the missing word. - The
rankPercentileelement (present only when the word exists) indicates how likely the word is to appear relative to other words. The most common one percent of words have arankPercentilevalue of 100 (so a greater value indicates a more common word). - The
occurrencesPerMillionelement (present only when the word exists) shows the number of times that the word is expected to occur in one million words.