> ## Documentation Index
> Fetch the complete documentation index at: https://api.finevoice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Emotion Tags

> Control tone and emotion in Text to Speech using Fish.Audio 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).

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

<Note>
  Tag names are **case-insensitive**. `[Happy]`, `[HAPPY]`, and `[happy]` are all equivalent.
</Note>

***

## 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.

```json theme={null}
// 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.

```json theme={null}
// 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.

```json theme={null}
// 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.

```json theme={null}
// 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]`      |