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 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.
[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 intext:
- cURL
- JavaScript
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.
Tips
Tone for customer service
Tone for customer service
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.Enhance never edits your wording
Enhance never edits your wording
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.