> ## Documentation Index
> Fetch the complete documentation index at: https://hanabiaiinc-auto-go-api-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Emotion Reference

> Complete reference guide for all 64+ emotional expressions in Fish Audio

## Complete Emotion List

This reference guide provides a comprehensive list of all 64+ supported emotional expressions and voice styles available in Fish Audio's TTS models.

## Basic Emotions (24)

| Emotion     | Tag             | Description             | Example Context             |
| ----------- | --------------- | ----------------------- | --------------------------- |
| Happy       | `(happy)`       | Cheerful, upbeat tone   | Good news, greetings        |
| Sad         | `(sad)`         | Melancholic, downcast   | Sympathy, bad news          |
| Angry       | `(angry)`       | Frustrated, aggressive  | Complaints, warnings        |
| Excited     | `(excited)`     | Energetic, enthusiastic | Announcements, celebrations |
| Calm        | `(calm)`        | Peaceful, relaxed       | Instructions, meditation    |
| Nervous     | `(nervous)`     | Anxious, uncertain      | Disclaimers, apologies      |
| Confident   | `(confident)`   | Assertive, self-assured | Presentations, sales        |
| Surprised   | `(surprised)`   | Shocked, amazed         | Reactions, discoveries      |
| Satisfied   | `(satisfied)`   | Content, pleased        | Confirmations, reviews      |
| Delighted   | `(delighted)`   | Very pleased, joyful    | Celebrations, compliments   |
| Scared      | `(scared)`      | Frightened, fearful     | Warnings, horror stories    |
| Worried     | `(worried)`     | Concerned, troubled     | Concerns, questions         |
| Upset       | `(upset)`       | Disturbed, distressed   | Complaints, problems        |
| Frustrated  | `(frustrated)`  | Annoyed, exasperated    | Technical issues, delays    |
| Depressed   | `(depressed)`   | Very sad, hopeless      | Serious topics              |
| Empathetic  | `(empathetic)`  | Understanding, caring   | Support, counseling         |
| Embarrassed | `(embarrassed)` | Ashamed, awkward        | Apologies, mistakes         |
| Disgusted   | `(disgusted)`   | Repelled, revolted      | Negative reviews            |
| Moved       | `(moved)`       | Emotionally touched     | Heartfelt moments           |
| Proud       | `(proud)`       | Accomplished, satisfied | Achievements, praise        |
| Relaxed     | `(relaxed)`     | At ease, casual         | Casual conversation         |
| Grateful    | `(grateful)`    | Thankful, appreciative  | Thanks, appreciation        |
| Curious     | `(curious)`     | Inquisitive, interested | Questions, exploration      |
| Sarcastic   | `(sarcastic)`   | Ironic, mocking         | Humor, criticism            |

## Advanced Emotions (25)

| Emotion       | Tag               | Description              | Example Context        |
| ------------- | ----------------- | ------------------------ | ---------------------- |
| Disdainful    | `(disdainful)`    | Contemptuous, scornful   | Criticism, rejection   |
| Unhappy       | `(unhappy)`       | Discontent, dissatisfied | Complaints, feedback   |
| Anxious       | `(anxious)`       | Very worried, uneasy     | Urgent matters         |
| Hysterical    | `(hysterical)`    | Uncontrollably emotional | Extreme reactions      |
| Indifferent   | `(indifferent)`   | Uncaring, neutral        | Neutral responses      |
| Uncertain     | `(uncertain)`     | Doubtful, unsure         | Speculation, questions |
| Doubtful      | `(doubtful)`      | Skeptical, questioning   | Disbelief, questioning |
| Confused      | `(confused)`      | Puzzled, perplexed       | Clarification requests |
| Disappointed  | `(disappointed)`  | Let down, dissatisfied   | Unmet expectations     |
| Regretful     | `(regretful)`     | Sorry, remorseful        | Apologies, mistakes    |
| Guilty        | `(guilty)`        | Culpable, responsible    | Confessions, apologies |
| Ashamed       | `(ashamed)`       | Deeply embarrassed       | Serious mistakes       |
| Jealous       | `(jealous)`       | Envious, resentful       | Comparisons            |
| Envious       | `(envious)`       | Wanting what others have | Admiration with desire |
| Hopeful       | `(hopeful)`       | Optimistic about future  | Future plans           |
| Optimistic    | `(optimistic)`    | Positive outlook         | Encouragement          |
| Pessimistic   | `(pessimistic)`   | Negative outlook         | Warnings, doubts       |
| Nostalgic     | `(nostalgic)`     | Longing for the past     | Memories, stories      |
| Lonely        | `(lonely)`        | Isolated, alone          | Emotional content      |
| Bored         | `(bored)`         | Uninterested, weary      | Disinterest            |
| Contemptuous  | `(contemptuous)`  | Showing contempt         | Strong criticism       |
| Sympathetic   | `(sympathetic)`   | Showing sympathy         | Condolences            |
| Compassionate | `(compassionate)` | Showing deep care        | Support, help          |
| Determined    | `(determined)`    | Resolved, decided        | Goals, commitments     |
| Resigned      | `(resigned)`      | Accepting defeat         | Giving up, acceptance  |

## Tone Markers (5)

| Tone       | Tag                 | Description          | When to Use                |
| ---------- | ------------------- | -------------------- | -------------------------- |
| Hurried    | `(in a hurry tone)` | Rushed, urgent       | Time-sensitive information |
| Shouting   | `(shouting)`        | Loud, calling out    | Getting attention          |
| Screaming  | `(screaming)`       | Very loud, panicked  | Emergencies, fear          |
| Whispering | `(whispering)`      | Very soft, secretive | Secrets, quiet scenes      |
| Soft       | `(soft tone)`       | Gentle, quiet        | Comfort, lullabies         |

## Audio Effects (10)

| Effect        | Tag               | Description                  | Suggested Text |
| ------------- | ----------------- | ---------------------------- | -------------- |
| Laughing      | `(laughing)`      | Full laughter                | Ha, ha, ha     |
| Chuckling     | `(chuckling)`     | Light laugh                  | Heh, heh       |
| Sobbing       | `(sobbing)`       | Crying heavily               | (optional)     |
| Crying Loudly | `(crying loudly)` | Intense crying               | (optional)     |
| Sighing       | `(sighing)`       | Exhale of relief/frustration | sigh           |
| Groaning      | `(groaning)`      | Sound of frustration         | ugh            |
| Panting       | `(panting)`       | Out of breath                | huff, puff     |
| Gasping       | `(gasping)`       | Sharp intake of breath       | gasp           |
| Yawning       | `(yawning)`       | Tired sound                  | yawn           |
| Snoring       | `(snoring)`       | Sleep sound                  | zzz            |

## Special Effects

| Effect              | Tag                     | Description              |
| ------------------- | ----------------------- | ------------------------ |
| Audience Laughter   | `(audience laughing)`   | Crowd laughing sound     |
| Background Laughter | `(background laughter)` | Ambient laughter         |
| Crowd Laughter      | `(crowd laughing)`      | Large group laughing     |
| Short Pause         | `(break)`               | Brief pause in speech    |
| Long Pause          | `(long-break)`          | Extended pause in speech |

## Usage Examples

### Single Emotion

```
(happy) What a beautiful day!
(sad) I'm sorry for your loss.
(excited) We won the championship!
```

### Combined Effects

```
(sad)(whispering) I'll miss you so much.
(angry)(shouting) Get out of here now!
(excited)(laughing) We did it! Ha ha ha!
```

### Natural Expressions

```
That's hilarious! Ha ha ha!  // Natural laughter
(sighing) Sigh... what a long day.
(panting) Huff... puff... almost there!
```

## Quick Selection Guide

### For Customer Service

* **Greetings**: `(friendly)`, `(cheerful)`, `(helpful)`
* **Understanding**: `(empathetic)`, `(concerned)`, `(sympathetic)`
* **Problem-solving**: `(confident)`, `(determined)`, `(professional)`
* **Apologies**: `(apologetic)`, `(regretful)`, `(sincere)`

### For Storytelling

* **Narration**: `(narrator)`, `(calm)`, `(mysterious)`
* **Character emotions**: Any from basic/advanced lists
* **Atmosphere**: `(whispering)`, `(dramatic)`, background effects
* **Action**: `(shouting)`, `(panting)`, `(struggling)`

### For Educational Content

* **Introduction**: `(enthusiastic)`, `(welcoming)`, `(friendly)`
* **Explanations**: `(calm)`, `(clear)`, `(patient)`
* **Questions**: `(curious)`, `(encouraging)`, `(thoughtful)`
* **Praise**: `(proud)`, `(delighted)`, `(impressed)`

### For Marketing

* **Excitement**: `(excited)`, `(enthusiastic)`, `(energetic)`
* **Trust**: `(confident)`, `(professional)`, `(sincere)`
* **Urgency**: `(urgent)`, `(in a hurry tone)`, `(important)`
* **Celebration**: `(celebrating)`, `(triumphant)`, `(joyful)`

## Emotion Categories

### Positive Emotions

`(happy)` `(excited)` `(delighted)` `(satisfied)` `(proud)` `(grateful)` `(confident)` `(relaxed)` `(hopeful)` `(optimistic)` `(moved)` `(compassionate)`

### Negative Emotions

`(sad)` `(angry)` `(frustrated)` `(depressed)` `(upset)` `(worried)` `(scared)` `(nervous)` `(disappointed)` `(regretful)` `(guilty)` `(ashamed)` `(lonely)` `(bored)`

### Neutral/Complex Emotions

`(calm)` `(curious)` `(surprised)` `(confused)` `(uncertain)` `(doubtful)` `(indifferent)` `(nostalgic)` `(sarcastic)` `(determined)` `(resigned)`

### Social/Interpersonal Emotions

`(empathetic)` `(sympathetic)` `(embarrassed)` `(jealous)` `(envious)` `(disdainful)` `(contemptuous)` `(disgusted)`

## Model Support Matrix

| Model           | Basic | Advanced | Tones | Effects | Intensity |
| --------------- | ----- | -------- | ----- | ------- | --------- |
| Fish Speech 1.5 | ✓     | Limited  | ✓     | 6/10    | No        |
| Fish Audio S1   | ✓     | ✓        | ✓     | ✓       | ✓         |

## Tips for Natural Speech

1. **Start Simple**: Begin with basic emotions before combining
2. **Test Variations**: Different voices handle emotions differently
3. **Context Matters**: Match emotions to content logically
4. **Less is More**: Avoid overusing emotions in short text
5. **Natural Flow**: Space out emotional changes
6. **Sound Effects**: Include appropriate text after audio tags
7. **Preview Often**: Test how emotions sound with your voice

## Common Mistakes to Avoid

* ❌ Placing emotion tags mid-sentence in English
* ❌ Forgetting parentheses around tags
* ❌ Using unsupported custom tags
* ❌ Mixing conflicting emotions
* ❌ Overusing effects in short text
* ❌ Missing text for sound effects
* ❌ Using wrong language placement rules

## See Also

* [Emotion Control Guide](/developer-guide/core-features/emotions) - Technical implementation
* [Text-to-Speech Best Practices](/developer-guide/core-features/text-to-speech)
* [API Reference](/api-reference/introduction)
* [Try it live](https://fish.audio) - Test emotions in the playground