Skip to main content
A pronunciation dictionary says how your account’s words are spoken, per language and, if you want, per voice. “BMW” is “be me ve” in Turkish and “bee em double-you” in English; “iPhone” is “ayfon” in Turkish. Every POST /v1/audio/speech request of your account uses its dictionary automatically: the rules for the request’s language (and the rules for every language), for its voice (and the rules for every voice). Nothing to add to the request. You can also manage it in the console: Pronunciation, with a ▶ button to hear each word before and after saving.

How a rule works

  • Whole words only: BMW does not change BMWs or xBMW.
  • Turkish endings stay: BMW'nin is said be me ve'nin, iPhone'unuz → ayfon'unuz.
  • Longest first: with rules for BMW Group and BMW, “BMW Group” uses the first. A replaced word is never matched again.
  • Then the normal reading: after the dictionary, numbers, dates, amounts and addresses are read as always.
  • The voices read text, not phonetic symbols: write the alias the way a speaker of the language would spell the sound. Listen to it once; if it is not right, change the spelling (spaces, hyphens, doubled letters) and listen again.
A dictionary belongs to your account in one region: rules made on tts.eu.mihu.ai are used there, rules made on tts.tr.mihu.ai there. Up to 1,000 rules per account.

Add a rule

A rule for the same words, language and voices replaces the earlier one. Several at once (201, {"object": "list", "data": [...]}):
"replace": true next to "rules" makes the list your whole dictionary (an import: earlier rules are removed).

List, change, delete

Invalid fields answer 400 with the field in error.param; a rule of another account answers 404.

Speech requests

Nothing changes in your requests. Each answer says how many rules were used in the X-Pronunciations header. To read a text without your dictionary (for example to compare), send "pronunciations": false:

Speech-to-text: the same words as hints

So that speech-to-text writes your words back the way they are written (“be me ve” → “BMW”), give the dictionary’s words to Umay as hints (Turkish):
The console’s Speech to Text page does this for you: the dictionary’s words appear as hints (dashed) when you transcribe Turkish.