> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sabi-tts-app.dev.neuralace.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Audio tags

> Inline tokens that make Capella's speech expressive — laughs, sighs, pauses, and emotional styles.

Audio tags are inline tokens you put in the `input` text to make speech expressive: laughs,
sighs, breaths, pauses, and emotional delivery. They work everywhere — the playground, the
HTTP API, and the streaming WebSocket. In the playground, the **Enhance** button inserts
them for you automatically.

There are two kinds of tags, with two different shapes.

## Event tags — a single transient sound

An event tag is a bare token followed by a space. It inserts one sound (a laugh, a sigh, a
cough…) at that point in the speech.

```
<|laugh|> That is hilarious.
She read it twice, <|sigh|> and still missed the clause.
```

### Supported events

| Category          | Tags                                                                          |
| ----------------- | ----------------------------------------------------------------------------- |
| Laughter & crying | `<\|laugh\|>` `<\|chuckle\|>` `<\|giggle\|>` `<\|laugh_harder\|>` `<\|cry\|>` |
| Breath            | `<\|breath\|>` `<\|inhale\|>` `<\|exhale\|>` `<\|sigh\|>` `<\|gasp\|>`        |
| Throat & nose     | `<\|cough\|>` `<\|throat_clear\|>` `<\|sniff\|>` `<\|yawn\|>`                 |
| Mouth sounds      | `<\|tsk\|>` `<\|tongue_click\|>` `<\|lip_smack\|>` `<\|gulp\|>`               |
| Reactions         | `<\|snort\|>` `<\|woo\|>` `<\|hum_tune\|>`                                    |
| Pacing            | `<\|pause\|>` `<\|long_pause\|>` `<\|clap\|>`                                 |

### Placement

* **Lead the sentence:** laugh, chuckle, giggle, laugh\_harder, hum\_tune, woo, yawn,
  throat\_clear, exhale, sigh, inhale, tsk, cough, cry, sniff.
* **Between clauses (mid-sentence):** breath, long\_pause, clap, gulp, snort, lip\_smack,
  tongue\_click.
* **Either slot:** pause, gasp.

### Onomatopoeia pairing (strongest effect)

Pair a voiced event with its sound word for the most convincing result; the bare token alone
gives a subtler effect:

```
<|laugh|> Hahaha!     <|giggle|> Hehehe,     <|laugh_harder|> HAHAHA!
<|gasp|> Gah!         <|snort|> Pfft,        <|woo|> Woo!
<|hum_tune|> Mmmm-mmm,
```

Breath types (`breath`, `inhale`, `exhale`, `sigh`, `pause`, `long_pause`) are always used
bare — no sound word.

<Note>
  `<|snort|>` is a derisive snort ("pfft"), not a nasal sniff — use `<|sniff|>` for nasal.
</Note>

## Style wraps — color a whole sentence

A style wrap sets the emotional delivery of one full sentence:

```
<|style_open|>excited<|style_body|> I finally got the offer! <|style_close|>
```

To change style, close the current wrap and open a new one back-to-back:

```
<|style_open|>excited<|style_body|> I finally got the job offer! <|style_close|><|style_open|>annoyed<|style_body|> But the commute is brutal. <|style_close|>
```

### Supported styles

**Emotions:**

```
thoughtful  curious   whispers     mischievously  joyful
excited     sad       surprised    angry          annoyed
sarcastic   tender    fearful      flirty         loud
awe         menacing  nervous      smug
```

**Accents:**

```
strong-british-accent  strong-german-accent  strong-french-accent
strong-italian-accent  southern-us-accent
```

If the feeling you want isn't listed (serious, monotone, fast, slow…), leave the sentence
untagged — neutral is the correct default. Nearest matches: warm/gentle/soft → `tender`,
happy → `joyful`, quietly/whisper → `whispers`, interested → `curious`, concerned/tense →
`nervous`, impressed → `awe`, terrified → `fearful`.

## Rules of thumb

1. Use the **exact tokens** — no spaces inside `<|…|>`, and only the tags listed here.
   Don't invent tags (`<|singing|>`, `<|music|>` etc. are not supported).
2. **At most one style per sentence**, and a style never carries past `<|style_close|>`.
3. Tags describe the **voice only** — no music, sound effects, or physical actions.
4. Add emphasis with a CAPITAL word, `?` / `!`, or `…` ellipses rather than piling on tags.
5. Pick tags that match the line's emotion; a contradicting tag sounds worse than none.

## Full example

Input text:

> My uncle thought the robot vacuum was a cat and fed it milk. I couldn't stop laughing.
> Then I got worried it might break.

Tagged:

```
<|laugh|> Hahaha! My uncle thought the robot vacuum was a cat and actually fed it milk. <|laugh_harder|> HAHAHA, I could not breathe. <|style_open|>nervous<|style_body|> Then I started worrying the poor thing might break completely. <|style_close|>
```