“Say it” link kit

Put a “Say it” button next to any word in your app, course, flashcards or Anki deck. The learner taps it, says the word, and gets a score for each sound — and for each tone in Mandarin — with the sound to fix. Free, no account, eight languages.

Paste anywhere: a chat, Padlet, Canva, Teams, an LMS, a QR code generator.

Try the link ↗

The link format

https://toneperfect.app/practice?text=phrase&lang=xx&src=your-code

  • text — the word or phrase, up to 120 characters, URL-encoded. Mandarin: characters (你好) or pinyin with tone marks or numbers (nǐ hǎo, ni3 hao3). Plain text only: HTML, links and over-long text are refused and the page opens empty.
  • lang — optional, default zh: zh Mandarin Chinese, en English, es Spanish, fr French, de German, ru Russian, ja Japanese, ko Korean.
  • src — optional, your code: 2–32 lowercase letters, digits, - or _. Pick one per product or channel (mysite, mysite-anki) so we can tell you how many of your learners tried it.

Examples:

  • https://toneperfect.app/practice?text=%E4%BD%A0%E5%A5%BD&src=mysite
  • https://toneperfect.app/practice?text=ni3%20hao3&src=mysite
  • https://toneperfect.app/practice?text=grenouille&lang=fr&src=mysite

The widget takes the same text and src with the language in the path: toneperfect.app/embed/say/zh?text=你好&src=mysite.

What the learner gets

  • The phrase, a microphone button and a score from 0 to 100 for what they said.
  • Mandarin: each syllable’s tone (the one expected and the one heard), initial and final.
  • Other languages: a score per word and the sound that came out weakest. English is scored against an American reference.
  • Then the TonePerfect app, if they want daily practice. Nothing is required: no sign-up to try.

It checks pronunciation of the text the learner reads; it is not a grade, a level or an exam score.

Limits, honestly

  • Free tries are capped per browser and per internet connection: a whole class on one school Wi-Fi runs out after a few students. Links work best for practice at home.
  • Single Mandarin characters score less reliably than two-character words; use words or short phrases.
  • Some school filters and LMS editors block iframes or scripts. The plain link and the HTML button always work, because they are just links.
  • The microphone needs a normal browser. Inside some in-app browsers (WeChat, Instagram) the learner may need “Open in browser”.

More

Want the five-word pronunciation test on a class page instead? Use the pronunciation test widget. Building an app and want scores in your own UI? See the pronunciation API. Questions or your numbers by code: contact us.