Emotion Tags - FineVoice API

FineVoice TTS voices are powered by Fish Audio. You can embed emotion tags directly in your text to control how the voice sounds.

Usage

Wrap a tag name in square brackets and insert it in your text field. Each tag applies to the text that follows it until the next tag (or end of string).

{
  "voice": "james",
  "text": "[happy] Hello! Welcome to FineVoice. [calm] Here is how to get started."
}

Tag names are case-insensitive. [Happy], [HAPPY], and [happy] are all equivalent.

Best Practices

Follow these guidelines to get the most natural-sounding output: 1. Place tags at the start of a sentence Tags work best when placed at the beginning of a sentence or a natural pause point, not mid-sentence or mid-word.

// Good
"text": "[excited] We just launched a new feature!"

// Avoid
"text": "We just [excited] launched a new feature!"

2. Match the tag to the content Choose a tag that reflects the actual meaning of the sentence. Mismatched emotion and content will produce awkward or unnatural output.

// Good — tone matches context
"text": "[grateful] Thank you so much for your support."

// Avoid — tone contradicts content
"text": "[angry] Thank you so much for your support."

3. Do not stack multiple tags consecutively Placing two or more tags back-to-back without any text between them is not supported and may cause unexpected behavior. Use one tag per sentence or paragraph.

// Good
"text": "[calm] Please follow the instructions carefully."

// Avoid
"text": "[calm][confident] Please follow the instructions carefully."

4. Use one tag per logical segment A single tag should cover one sentence or one short paragraph. Avoid switching tags too frequently — this can make the speech sound unnatural.

// Good
"text": "[excited] We are thrilled to announce our new product! [calm] Here is everything you need to know."

// Avoid — too many switches
"text": "[excited] We are [calm] thrilled [happy] to announce [confident] our new product!"

Basic Emotions

Tag	Description	Common Use Case
`[happy]`	Cheerful, upbeat tone	Good news, greetings
`[sad]`	Melancholic, downcast	Sympathy, bad news
`[angry]`	Frustrated, aggressive	Complaints, warnings
`[excited]`	Energetic, enthusiastic	Announcements, celebrations
`[calm]`	Peaceful, relaxed	Instructions, meditation
`[nervous]`	Anxious, uncertain	Disclaimers, apologies
`[confident]`	Assertive, self-assured	Presentations, sales
`[surprised]`	Shocked, amazed	Reactions, discoveries
`[satisfied]`	Content, pleased	Confirmations, reviews
`[delighted]`	Very pleased, joyful	Celebrations, compliments
`[scared]`	Frightened, fearful	Warnings, horror stories
`[worried]`	Concerned, troubled	Concerns, questions
`[upset]`	Disturbed, distressed	Complaints, problems
`[frustrated]`	Annoyed, exasperated	Technical issues, delays
`[depressed]`	Very sad, hopeless	Serious topics
`[empathetic]`	Understanding, caring	Support, counseling
`[embarrassed]`	Ashamed, awkward	Apologies, mistakes
`[disgusted]`	Repelled, revolted	Negative reviews
`[moved]`	Emotionally touched	Heartfelt moments
`[proud]`	Accomplished, satisfied	Achievements, praise
`[relaxed]`	At ease, casual	Casual conversation
`[grateful]`	Thankful, appreciative	Thanks, appreciation
`[curious]`	Inquisitive, interested	Questions, exploration
`[sarcastic]`	Ironic, mocking	Humor, criticism

Advanced Emotions

Tag	Description	Common Use Case
`[disdainful]`	Contemptuous, scornful	Criticism, rejection
`[unhappy]`	Discontent, dissatisfied	Complaints, feedback
`[anxious]`	Very worried, uneasy	Urgent matters
`[hysterical]`	Uncontrollably emotional	Extreme reactions
`[indifferent]`	Uncaring, neutral	Neutral responses
`[uncertain]`	Doubtful, unsure	Speculation, questions
`[doubtful]`	Skeptical, questioning	Disbelief, questioning
`[confused]`	Puzzled, perplexed	Clarification requests
`[disappointed]`	Let down, dissatisfied	Unmet expectations
`[regretful]`	Sorry, remorseful	Apologies, mistakes
`[guilty]`	Culpable, responsible	Confessions, apologies
`[ashamed]`	Deeply embarrassed	Serious mistakes
`[jealous]`	Envious, resentful	Comparisons
`[envious]`	Wanting what others have	Admiration with desire
`[hopeful]`	Optimistic about future	Future plans
`[optimistic]`	Positive outlook	Encouragement
`[pessimistic]`	Negative outlook	Warnings, doubts
`[nostalgic]`	Longing for the past	Memories, stories
`[lonely]`	Isolated, alone	Emotional content
`[bored]`	Uninterested, weary	Disinterest
`[contemptuous]`	Showing contempt	Strong criticism
`[sympathetic]`	Showing sympathy	Condolences
`[compassionate]`	Showing deep care	Support, help
`[determined]`	Resolved, decided	Goals, commitments
`[resigned]`	Accepting defeat	Giving up, acceptance

Tone Markers

Tag	Description	Common Use Case
`[in a hurry tone]`	Rushed, urgent	Time-sensitive information
`[shouting]`	Loud, calling out	Getting attention
`[screaming]`	Very loud, panicked	Emergencies, fear
`[whispering]`	Very soft, secretive	Secrets, quiet scenes
`[soft tone]`	Gentle, quiet	Comfort, lullabies

Audio Effects

These tags insert a natural human sound instead of modifying spoken text.

Tag	Description
`[laughing]`	Full laughter
`[chuckling]`	Light laugh
`[sobbing]`	Crying heavily
`[crying loudly]`	Intense crying
`[sighing]`	Exhale of relief or frustration
`[groaning]`	Sound of frustration
`[panting]`	Out of breath
`[gasping]`	Sharp intake of breath
`[yawning]`	Tired sound
`[snoring]`	Sleep sound

Special Effects

Tag	Description
`[audience laughing]`	Crowd laughing sound
`[background laughter]`	Ambient laughter
`[crowd laughing]`	Large group laughing
`[break]`	Brief pause in speech
`[long-break]`	Extended pause in speech

Aliases

The following aliases are accepted and map to the corresponding canonical tag:

Alias	Maps To
`[neutral]`	`[indifferent]`
`[robotic]` / `[robot]` / `[mechanical]` / `[electronic]`	`[calm]`
`[professional]`	`[confident]`
`[friendly]` / `[cheerful]`	`[happy]`
`[energetic]` / `[dramatic]` / `[enthusiastic]` / `[celebrating]`	`[excited]`
`[fearful]`	`[scared]`
`[apologetic]`	`[regretful]`
`[sincere]` / `[important]` / `[helpful]` / `[clear]` / `[patient]`	`[confident]`
`[urgent]`	`[in a hurry tone]`
`[mysterious]` / `[narrator]`	`[calm]`
`[concerned]`	`[worried]`
`[triumphant]`	`[proud]`
`[joyful]` / `[impressed]`	`[delighted]`
`[welcoming]`	`[happy]`
`[encouraging]`	`[hopeful]`
`[thoughtful]`	`[curious]`
`[struggling]`	`[frustrated]`

​Usage

​Best Practices

​Basic Emotions

​Advanced Emotions

​Tone Markers

​Audio Effects

​Special Effects

​Aliases

Usage

Best Practices

Basic Emotions

Advanced Emotions

Tone Markers

Audio Effects

Special Effects

Aliases