Emotion Tags

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]`

API documentation

Text to Speech

Voice Conversion

Speech to Text

Sound Effects

Audio Separation

Podcast Generation

Task Status

AI Voices

Voice Design

AI Voice Cloning

Music Generation

Audio Enhancement

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

Usage

Best Practices

Basic Emotions

Advanced Emotions

Tone Markers

Audio Effects

Special Effects

Aliases