Skip to main content

Overview

Write a tag in square brackets and the voice changes how it speaks from that point on. Add a sound tag and the voice laughs, sighs or pauses right there.
Tags are never read aloud. A tag that is not on the lists below is silently dropped, so a typo never gets spoken, but it does nothing either.
Tags work on POST /tts-synthesize and in the Text to Speech page of the dashboard. They are not applied by POST /tts-stream.

Two kinds of tags

Emotion tags

Change how the following sentences sound. The emotion stays on until the next emotion tag. [neutral] switches it off.

Sound tags

Insert a non-verbal sound at that spot, such as a laugh or a sigh. They do not change the current emotion.
Tags are case-insensitive: [Happy], [HAPPY] and [happy] are the same. Text with no tags is still read with natural emotion; explicit tags always win.

Emotion tags

Tuned for Hindi, Indian English, Tamil, Telugu, Bengali, Marathi, Gujarati, Kannada, Malayalam, Punjabi and Odia. Emotions sound best when the text language matches the voice’s language.

Sound tags

Combining tags

  • Blend two emotions in one tag, separated by a comma: [sad, calm]. The first emotion sets the speaking speed. Keep blends to two emotions; more gets muddy.
  • Good blends: [empathetic, calm], [apologetic, calm], [happy, excited], [serious, calm], [curious, playful], [surprised, happy].
  • Avoid opposites such as [happy, sad] or [angry, calm]. They cancel each other out.
  • Never put an emotion and a sound in one bracket. In [laugh, happy] the emotion is ignored. Write two tags: [happy] [laugh] That's great!

Placement rules

1

Put every tag at the start of a sentence

[happy] Your refund has been approved! Change emotion at sentence boundaries, not mid-sentence.
2

Sound tags go before the words

[laugh] That's a good one! Don’t put a sound tag in the middle of a sentence.
3

Go easy on sounds

At most one sound tag per sentence, and about one per two or three sentences.
4

Leave a space after a tag

[happy] Hello, not [happy]Hello. Anything inside [...] is removed from the speech, so never put words you want spoken inside brackets.

Using tags through the API

Put the tags straight in text:
Tags count toward the 5,000-character text limit.

Enhance: let AI place the tags

Don’t want to place tags by hand? Enhance reads your text and inserts emotion and sound tags where they fit. It only adds tags: your words, spelling, numbers, names, punctuation, spacing and language stay exactly as you wrote them. Sentences you already tagged are left alone. In the dashboard, click Enhance above the text box. Review the result, edit it freely, use Undo enhance to go back, or Remove tags to take every tag out again. To add a single tag by hand, click Add emotion. Enhance is also available as an endpoint: see Enhance Text.
Enhance never runs automatically and never charges credits. Only the speech you generate afterwards does.

Tips

Prefer calm, empathetic, apologetic, happy and serious. Save angry, crying, frustrated, tired, whisper and sarcastic for text that clearly calls for them, and never use sarcastic toward a customer’s complaint.
Two to four emotion changes is plenty for a short script. If an enhanced script has a tag on every sentence, delete some or use Remove tags and add a few back.
Enhance can’t change, add or remove a word, so names, amounts and dates are safe. It only chooses where tags go, so read the result before generating and delete any tag you don’t want.