Inline control tokens that shape emotion, style, prosody, and sound effects inside the input text.
Inline tags control delivery at the token level. Insert them anywhere in input, and the model adjusts the surrounding speech. For example:
<|emotion:enthusiasm|>Welcome to the show!<|prosody:pause|>Let's get started!
Tags fall into five categories:
emotion: <|emotion:…|>, such as elation, fear, anger.
style: <|style:…|>, such as shouting, whispering.
sound effects: <|sfx:…|>, such as cough, sneeze.
prosody: <|prosody:…|>, including speed, pause, pitch, and expressiveness.
other: <|reset|>, which resets delivery to neutral.
Only the tags on this page are accepted. Any other <|...|> in the input is refused with 400 invalid_field_value, naming the tag, so a typo fails instead of being read aloud.Recommended usage:
Set delivery with delivery tokens. Emotion, style, speed, pitch, and expressiveness tags set how the text after them is delivered. Place them at the start of the input to set delivery for the whole turn. To change delivery partway through, add a new group of delivery tokens where the change begins. A new group replaces the previous one entirely: in <|emotion:anger|><|prosody:speed_fast|>Text one. <|emotion:sadness|>Text two., “Text two.” is sad at normal speed. Use <|reset|> to clear all delivery tokens and return to neutral delivery.
Place positional tokens exactly where they take effect. <|prosody:pause|> and <|prosody:long_pause|> go where the break should fall, and each <|sfx:…|> goes right before the sound it triggers.
Pair every sound effect with onomatopoeia. A <|sfx:…|> token works best when the matching written sound follows immediately, such as <|sfx:laughter|>Haha, <|sfx:sigh|>Uh, or <|sfx:sneeze|>Achoo. The written cue helps the model realize the sound effect.
Emotion
Tag
Effect
Sample input
Sample audio
<|emotion:elation|>
Elation / joy
<|emotion:elation|>This is the best news ever, I am absolutely thrilled!
<|emotion:amusement|>
Amusement / playful laughter
<|emotion:amusement|>Oh that's hilarious, I can't stop giggling about it.
<|emotion:enthusiasm|>
Enthusiasm / excitement
<|emotion:enthusiasm|>Let's go, I can't wait, this is going to be amazing!
<|emotion:determination|>
Determination / firmness
<|emotion:determination|>No matter what happens, I will not give up on this.
<|emotion:pride|>
Pride / confidence
<|emotion:pride|>Look at how far I've come. I never once doubted that I'd make it here.
<|emotion:contentment|>
Calm satisfaction
<|emotion:contentment|>Everything feels just right, I'm perfectly at peace.
<|emotion:affection|>
Warmth / affection
<|emotion:affection|>I'm so grateful to have you in my life, truly.
<|emotion:relief|>
Relief
<|emotion:relief|>Oh thank goodness, it's finally over, what a relief.
<|emotion:contemplation|>
Thoughtful / reflective
<|emotion:contemplation|>Sometimes I just sit and wonder what it all really means.
<|emotion:confusion|>
Confused
<|emotion:confusion|>Wait, I don't understand, what is even going on here?
<|emotion:surprise|>
Surprised
<|emotion:surprise|>What? No way, I did not see that coming at all!
<|emotion:awe|>
Awe / wonder
<|emotion:awe|>Wow, look at that, I have never seen anything so breathtaking.
<|emotion:longing|>
Longing / yearning
<|emotion:longing|>I miss you more than words can say, please come back to me.
<|emotion:arousal|>
Heightened desire
<|emotion:arousal|>Come closer, I can't stop thinking about you tonight.
<|emotion:anger|>
Anger
<|emotion:anger|>How dare you do that to me, this is completely unacceptable!
<|emotion:fear|>
Fear
<|emotion:fear|>Did you hear that? Something is out there, I'm really scared.
<|emotion:disgust|>
Disgust
<|emotion:disgust|>Ugh, that is absolutely revolting, I can't even look at it.
<|emotion:bitterness|>
Bitterness
<|emotion:bitterness|>After everything I did for them, this is how they repay me.
<|emotion:sadness|>
Sadness
<|emotion:sadness|>I really thought things would be different, it hurts so much.
<|emotion:shame|>
Shame
<|emotion:shame|>I can't believe I did that, I'm so embarrassed and ashamed.
<|emotion:helplessness|>
Helplessness
<|emotion:helplessness|>There's nothing I can do anymore, I just feel so powerless.
Style
Tag
Effect
Sample input
Sample audio
<|style:singing|>
Singing
<|style:singing|>Dancing in the rain, feeling so alive again.
<|style:shouting|>
Shouting / projected voice
<|style:shouting|>Hey! Over here! Everybody listen to me right now!
<|style:whispering|>
Whisper
<|style:whispering|>Lean in, I have a little secret just for you, don't tell anyone.
Sound effects
Sound effects are vocalized — produced in the speaker’s voice — not mixed-in audio assets.
Tag
Effect
Sample input
Sample audio
<|sfx:cough|>
Cough
<|sfx:cough|>Ahem, could I have everyone's attention, please?
<|sfx:laughter|>
Laughter
<|sfx:laughter|>Haha, that's the funniest thing I've heard all day!
<|sfx:crying|>
Crying
<|emotion:sadness|><|sfx:crying|>I... I’m sorry.
<|sfx:screaming|>
Screaming
<|sfx:screaming|>Ah, no, no, this can't be happening!
<|sfx:burping|>
Burping
<|sfx:burping|>Burp—ugh, whoa, sorry, that one snuck up on me.
<|sfx:humming|>
Humming
<|sfx:humming|>Hmm, that's a tricky question, isn't it?
<|sfx:sigh|>
Sigh
<|sfx:sigh|>Ahh, well, there's nothing left to do but wait.
<|sfx:sniff|>
Sniff
<|sfx:sniff|>Sff..., it's so cold out, my nose won't stop.
<|sfx:sneeze|>
Sneeze
<|sfx:sneeze|>Achoo! Bless you, oh wait, that was me.
Prosody
Prosody tags control speed, pitch, pauses, and overall expressiveness.
Tag
Effect
Sample input
Sample audio
<|prosody:speed_very_slow|>
~0.65× speed
<|prosody:speed_very_slow|>Take your time, <|prosody:pause|> there is, <|prosody:pause|> really no need <|prosody:pause|> to rush <|prosody:pause|> at all.
<|prosody:speed_slow|>
~0.85× speed
<|prosody:speed_slow|>Let me explain this slowly, so everyone can follow along.
<|prosody:speed_fast|>
~1.2× speed
<|prosody:speed_fast|>Quick, quick, we have to go right now, we're running late!
<|prosody:speed_very_fast|>
~1.4× speed
<|prosody:speed_very_fast|>Wait wait wait, two minutes till the train, no time to talk, just run run, go go go!
<|prosody:pitch_low|>
~−3 semitones
<|prosody:pitch_low|>In a deep and serious voice, he delivered the grave news.
<|prosody:pitch_high|>
~+2.5 semitones
<|prosody:pitch_high|>Oh hello there little one, aren't you just the cutest!
<|prosody:pause|>
~400–700 ms pause
Wait for it <|prosody:pause|> and there it is, the big reveal.
<|prosody:long_pause|>
~700–1500 ms pause
I have something important to tell you. <|prosody:long_pause|> I'm leaving tomorrow.
<|prosody:expressive_high|>
More expressive delivery
<|prosody:expressive_high|>This is incredible, absolutely magnificent, beyond my wildest dreams!
<|prosody:expressive_low|>
Flatter delivery
<|prosody:expressive_low|>The meeting is at noon. Bring your reports. That's all.
Other
Tag
Effect
Sample input
Sample audio
<|reset|>
Resets to neutral delivery
<|emotion:sadness|><|prosody:speed_slow|>She waited by the window every night, hoping he would come home. But the seasons changed, the years went by, and he never did. <|reset|>That concludes chapter three. Chapter four begins on the next page.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Boson","description":"Build with Higgs Realtime, Higgs TTS 3, and Higgs Avatar APIs.","colors":{"primary":"#17B726","light":"#3DD24A","dark":"#1D7028"},"logo":{"light":"https://mintcdn.com/bosonai/nle8KC3HRTUuBQvw/public/images/boson_ai_logo.svg?fit=max\u0026auto=format\u0026n=nle8KC3HRTUuBQvw\u0026q=85\u0026s=a612c3151ec7dfaae986ba9f8053392b","dark":"https://mintcdn.com/bosonai/nle8KC3HRTUuBQvw/public/images/logo_light.svg?fit=max\u0026auto=format\u0026n=nle8KC3HRTUuBQvw\u0026q=85\u0026s=2aa7370dbe21e0a611129de5bd0dd16d"},"favicon":"https://mintcdn.com/bosonai/nle8KC3HRTUuBQvw/public/images/favicon.ico?fit=max\u0026auto=format\u0026n=nle8KC3HRTUuBQvw\u0026q=85\u0026s=24cc72e718eee5ab1ef7451dd1624648","navbar":{"links":[{"href":"/feedback","label":"Feedback"}],"primary":{"type":"button","label":"Workspace","href":"https://www.boson.ai/workspace"}},"footer":{"socials":{"x":"https://x.com/boson_ai","github":"https://github.com/boson-ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bosonai","hasAudioNarration":false,"actualSubdomain":"bosonai","customDomains":["docs.boson.ai"],"gitSource":{"type":"github","owner":"boson-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af786528d326e366b9e4791","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"default","tag":"Documentation","count":30},{"language":"default","tag":"API Reference","count":23},{"language":"default","tag":"Higgs Realtime","count":9},{"language":"default","tag":"Avatar Realtime API","count":8},{"language":"default","tag":"Higgs TTS 3","count":7},{"language":"default","tag":"Text-to-Speech API","count":6},{"language":"default","tag":"Get started","count":6},{"language":"default","tag":"Realtime API","count":4},{"language":"default","tag":"Higgs Avatar","count":4},{"language":"default","tag":"Guides","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#sidebar [data-sidebar-group-title],#sidebar .sidebar-group-title,#sidebar [class*=\"GroupTitle\"],aside [data-sidebar-group-title],aside .sidebar-group-title,aside [class*=\"GroupTitle\"],nav[aria-label=\"Sidebar\"] li>h5,nav[aria-label=\"Sidebar\"] li>h4,nav[aria-label=\"Sidebar\"] li>div[class*=\"font-semibold\"]:first-child{font-size:0.7rem!important;font-weight:600!important;letter-spacing:0.08em!important;text-transform:uppercase!important;color:rgb(115, 115, 115)!important;margin-top:1.25rem!important;margin-bottom:0.5rem!important}html.dark #sidebar [data-sidebar-group-title],html.dark #sidebar .sidebar-group-title,html.dark #sidebar [class*=\"GroupTitle\"],html.dark aside [data-sidebar-group-title],html.dark aside .sidebar-group-title,html.dark aside [class*=\"GroupTitle\"],html.dark nav[aria-label=\"Sidebar\"] li>h5,html.dark nav[aria-label=\"Sidebar\"] li>h4,html.dark nav[aria-label=\"Sidebar\"] li>div[class*=\"font-semibold\"]:first-child{color:rgb(160, 160, 160)!important}main table th:not(:last-child),main table td:not(:last-child){white-space:nowrap;width:1%}main table th:last-child,main table td:last-child{width:auto;min-width:14rem;white-space:normal}main table th,main table td{vertical-align:middle!important}@media (max-width: 640px){main .expand-schema-container,main .expand-schema-container>div,main .expand-schema-container .border-none,main .expand-schema-container .font-mono.font-bold,main .expand-schema-container .text-xs.truncate{max-width:100%;min-width:0}}main .realtime-event-catalog>p,main .realtime-event-catalog>[data-as=\"p\"],main .realtime-event-catalog>ul,main .realtime-event-catalog>ol{font-size:0.875rem;line-height:1.5rem}main .realtime-event-catalog>[data-as=\"p\"]{display:block;margin-top:1.25em;margin-bottom:1.25em}main .realtime-event-catalog>h2{font-size:1.125rem;line-height:1.6875rem}main .realtime-event-catalog>h3{font-size:1rem;line-height:1.5rem}main .realtime-event-catalog table{font-size:0.8125rem;line-height:1.25rem;table-layout:auto;width:100%}main .realtime-event-catalog table th,main .realtime-event-catalog table td,main .realtime-event-catalog table th:not(:last-child),main .realtime-event-catalog table td:not(:last-child),main .realtime-event-catalog table th:last-child,main .realtime-event-catalog table td:last-child{min-width:0;white-space:normal;width:auto}main .realtime-event-catalog table code{overflow-wrap:anywhere;word-break:break-word}main .wrap-table table th,main .wrap-table table td,main .wrap-table table th:not(:last-child),main .wrap-table table td:not(:last-child),main .wrap-table table th:last-child,main .wrap-table table td:last-child{min-width:0;white-space:normal;width:auto}main .wrap-table table code{overflow-wrap:anywhere}main .tags-sample-tables table{border-collapse:separate;border-spacing:0 0.75rem;display:block;width:100%}main .tags-sample-tables table thead{display:none}main .tags-sample-tables table tbody{display:grid;gap:0.75rem}main .tags-sample-tables table tr{border:1px solid rgb(229, 229, 229);border-radius:0.5rem;display:grid;gap:0.5rem 1rem;grid-template-columns:minmax(8rem, max-content) 1fr 14rem;padding:0.875rem 1rem}html.dark main .tags-sample-tables table tr{border-color:rgb(64, 64, 64)}main .tags-sample-tables table td{border:0!important;padding:0!important;white-space:normal!important;width:auto}main .tags-sample-tables table td::before{color:rgb(115, 115, 115);display:block;font-size:0.75rem;font-weight:600;margin-bottom:0.125rem}html.dark main .tags-sample-tables table td::before{color:rgb(160, 160, 160)}main .tags-sample-tables table td:nth-child(1)::before{content:\"Tag\"}main .tags-sample-tables table td:nth-child(1) code{background:rgb(237, 247, 237);border:1px solid rgb(188, 220, 188);color:rgb(29, 112, 40);font-weight:700}html.dark main .tags-sample-tables table td:nth-child(1) code{background:rgba(34, 197, 94, 0.12);border-color:rgba(34, 197, 94, 0.35);color:rgb(134, 239, 172)}main .tags-sample-tables table td:nth-child(2)::before{content:\"Effect\"}main .tags-sample-tables table td:nth-child(3)::before{content:\"Sample input\"}main .tags-sample-tables table td:nth-child(4)::before{content:\"Sample audio\"}main .tags-sample-tables table td:nth-child(2){grid-column:2 / -1}main .tags-sample-tables table td:nth-child(3){grid-column:1 / 3}main .tags-sample-tables table td:nth-child(4){grid-column:3 / 4;grid-row:2}main .tags-sample-tables table td:nth-child(3) code{display:inline;overflow-wrap:anywhere;word-break:break-word;white-space:normal}main .tags-sample-tables table audio{display:block;max-width:100%;width:14rem}main .voice-sample-tables table{border-collapse:separate;border-spacing:0 0.75rem;display:block;width:100%}main .voice-sample-tables table thead{display:none}main .voice-sample-tables table tbody{display:grid;gap:0.75rem}main .voice-sample-tables table tr{border:1px solid rgb(229, 229, 229);border-radius:0.5rem;display:grid;gap:0.5rem 1rem;grid-template-columns:minmax(6rem, max-content) 1fr 14rem;padding:0.875rem 1rem}html.dark main .voice-sample-tables table tr{border-color:rgb(64, 64, 64)}main .voice-sample-tables table td{border:0!important;padding:0!important;white-space:normal!important;width:auto}main .voice-sample-tables table td::before{color:rgb(115, 115, 115);display:block;font-size:0.75rem;font-weight:600;margin-bottom:0.125rem}html.dark main .voice-sample-tables table td::before{color:rgb(160, 160, 160)}main .voice-sample-tables table td:nth-child(1)::before{content:\"Voice\"}main .voice-sample-tables table td:nth-child(1) code{background:rgb(237, 247, 237);border:1px solid rgb(188, 220, 188);color:rgb(29, 112, 40);font-weight:700}html.dark main .voice-sample-tables table td:nth-child(1) code{background:rgba(34, 197, 94, 0.12);border-color:rgba(34, 197, 94, 0.35);color:rgb(134, 239, 172)}main .voice-sample-tables table td:nth-child(2)::before{content:\"Style\"}main .voice-sample-tables table td:nth-child(3)::before{content:\"Sample input\"}main .voice-sample-tables table td:nth-child(4)::before{content:\"Sample audio\"}main .voice-sample-tables table td:nth-child(2){grid-column:2 / -1}main .voice-sample-tables table td:nth-child(3){grid-column:1 / 3}main .voice-sample-tables table td:nth-child(4){grid-column:3 / 4;grid-row:2}main .voice-sample-tables table td:nth-child(3) code{display:inline;overflow-wrap:anywhere;word-break:break-word;white-space:normal}main .voice-sample-tables table audio{display:block;max-width:100%;width:14rem}main .fine-control-sample-table table{border-collapse:separate;border-spacing:0;display:block;width:100%}main .fine-control-sample-table table thead{display:none}main .fine-control-sample-table table tr{border:1px solid rgb(229, 229, 229);border-radius:0.5rem;display:grid;gap:0.5rem 1rem;grid-template-columns:1fr 14rem;padding:0.875rem 1rem}html.dark main .fine-control-sample-table table tr{border-color:rgb(64, 64, 64)}main .fine-control-sample-table table td{border:0!important;padding:0!important;white-space:normal!important;width:auto!important}main .fine-control-sample-table table td::before{color:rgb(115, 115, 115);display:block;font-size:0.75rem;font-weight:600;margin-bottom:0.125rem}html.dark main .fine-control-sample-table table td::before{color:rgb(160, 160, 160)}main .fine-control-sample-table table td:nth-child(1)::before{content:\"Sample input\"}main .fine-control-sample-table table td:nth-child(2)::before{content:\"Sample audio\"}main .fine-control-sample-table table td:nth-child(1) code{display:inline;overflow-wrap:anywhere;word-break:break-word;white-space:normal}main .fine-control-sample-table table audio{display:block;margin-top:0.35rem;max-width:100%;width:14rem}img[src*=\"boson_ai_logo\"],img[src*=\"logo_light\"]{height:1.5rem!important;max-height:1.5rem!important;width:auto!important}@media (max-width: 768px){main table{display:block;max-width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}main table td:last-child,main table th:last-child{min-width:16rem}main .tags-sample-tables table tr{display:block;min-width:0;width:100%}main .tags-sample-tables table tbody,main .tags-sample-tables table td{display:block;min-width:0!important;width:100%!important}main .tags-sample-tables table td+td{margin-top:0.45rem}main .tags-sample-tables table audio{width:12rem}main .voice-sample-tables table tr{display:block;min-width:0;width:100%}main .voice-sample-tables table tbody,main .voice-sample-tables table td{display:block;min-width:0!important;width:100%!important}main .voice-sample-tables table td+td{margin-top:0.45rem}main .voice-sample-tables table audio{width:12rem}main .fine-control-sample-table table tr{display:block;min-width:0;width:100%}main .fine-control-sample-table table td{display:block;min-width:0!important;width:100%!important}main .fine-control-sample-table table td+td{margin-top:0.45rem}main .fine-control-sample-table table audio{width:12rem}}#content-area:has(.speech-live-page)>#pagination{margin-top:2.5rem}"}],"page":{"pagePath":"models/higgs-tts/tags","slug":"/models/higgs-tts/tags","pageMetadata":{"title":"Tags","description":"Inline control tokens that shape emotion, style, prosody, and sound effects inside the input text.","href":"/models/higgs-tts/tags"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Inline control tokens that shape emotion, style, prosody, and sound effects inside the input text.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Inline tags control delivery at the token level. Insert them anywhere in `,_jsx(_components.code,{children:`input`}),`, and the model adjusts the surrounding speech. For example:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`\u003c|emotion:enthusiasm|>Welcome to the show!`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`\u003c|prosody:pause|>Let's get started!`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Tags fall into five categories:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`emotion`}),`: `,_jsx(_components.code,{children:`\u003c|emotion:…|>`}),`, such as elation, fear, anger.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`style`}),`: `,_jsx(_components.code,{children:`\u003c|style:…|>`}),`, such as shouting, whispering.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`sound effects`}),`: `,_jsx(_components.code,{children:`\u003c|sfx:…|>`}),`, such as cough, sneeze.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`prosody`}),`: `,_jsx(_components.code,{children:`\u003c|prosody:…|>`}),`, including speed, pause, pitch, and expressiveness.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`other`}),`: `,_jsx(_components.code,{children:`\u003c|reset|>`}),`, which resets delivery to neutral.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Only the tags on this page are accepted. Any other `,_jsx(_components.code,{children:`\u003c|...|>`}),` in the input is refused with 400 `,_jsx(_components.code,{children:`invalid_field_value`}),`, naming the tag, so a typo fails instead of being read aloud.`]}),`\n`,_jsx(_components.p,{children:`Recommended usage:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Set delivery with delivery tokens. Emotion, style, speed, pitch, and expressiveness tags set how the text after them is delivered. Place them at the start of the input to set delivery for the whole turn. To change delivery partway through, add a new group of delivery tokens where the change begins. A new group replaces the previous one entirely: in `,_jsx(_components.code,{children:`\u003c|emotion:anger|>\u003c|prosody:speed_fast|>Text one. \u003c|emotion:sadness|>Text two.`}),`, “Text two.” is sad at normal speed. Use `,_jsx(_components.code,{children:`\u003c|reset|>`}),` to clear all delivery tokens and return to neutral delivery.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Place positional tokens exactly where they take effect. `,_jsx(_components.code,{children:`\u003c|prosody:pause|>`}),` and `,_jsx(_components.code,{children:`\u003c|prosody:long_pause|>`}),` go where the break should fall, and each `,_jsx(_components.code,{children:`\u003c|sfx:…|>`}),` goes right before the sound it triggers.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Pair every sound effect with onomatopoeia. A `,_jsx(_components.code,{children:`\u003c|sfx:…|>`}),` token works best when the matching written sound follows immediately, such as `,_jsx(_components.code,{children:`\u003c|sfx:laughter|>Haha`}),`, `,_jsx(_components.code,{children:`\u003c|sfx:sigh|>Uh`}),`, or `,_jsx(_components.code,{children:`\u003c|sfx:sneeze|>Achoo`}),`. The written cue helps the model realize the sound effect.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(`div`,{className:`tags-sample-tables`,children:[_jsx(Heading,{level:`2`,id:`emotion`,children:`Emotion`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tag`}),_jsx(_components.th,{children:`Effect`}),_jsx(_components.th,{children:`Sample input`}),_jsx(_components.th,{children:`Sample audio`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:elation|>`})}),_jsx(_components.td,{children:`Elation / joy`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:elation|>This is the best news ever, I am absolutely thrilled!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_elation.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:amusement|>`})}),_jsx(_components.td,{children:`Amusement / playful laughter`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:amusement|>Oh that's hilarious, I can't stop giggling about it.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_amusement.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:enthusiasm|>`})}),_jsx(_components.td,{children:`Enthusiasm / excitement`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:enthusiasm|>Let's go, I can't wait, this is going to be amazing!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_enthusiasm.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:determination|>`})}),_jsx(_components.td,{children:`Determination / firmness`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:determination|>No matter what happens, I will not give up on this.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_determination.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:pride|>`})}),_jsx(_components.td,{children:`Pride / confidence`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:pride|>Look at how far I've come. I never once doubted that I'd make it here.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_pride.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:contentment|>`})}),_jsx(_components.td,{children:`Calm satisfaction`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:contentment|>Everything feels just right, I'm perfectly at peace.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_contentment.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:affection|>`})}),_jsx(_components.td,{children:`Warmth / affection`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:affection|>I'm so grateful to have you in my life, truly.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_affection.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:relief|>`})}),_jsx(_components.td,{children:`Relief`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:relief|>Oh thank goodness, it's finally over, what a relief.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_relief.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:contemplation|>`})}),_jsx(_components.td,{children:`Thoughtful / reflective`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:contemplation|>Sometimes I just sit and wonder what it all really means.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_contemplation.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:confusion|>`})}),_jsx(_components.td,{children:`Confused`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:confusion|>Wait, I don't understand, what is even going on here?`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_confusion.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:surprise|>`})}),_jsx(_components.td,{children:`Surprised`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:surprise|>What? No way, I did not see that coming at all!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_surprise.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:awe|>`})}),_jsx(_components.td,{children:`Awe / wonder`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:awe|>Wow, look at that, I have never seen anything so breathtaking.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_awe.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:longing|>`})}),_jsx(_components.td,{children:`Longing / yearning`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:longing|>I miss you more than words can say, please come back to me.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_longing.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:arousal|>`})}),_jsx(_components.td,{children:`Heightened desire`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:arousal|>Come closer, I can't stop thinking about you tonight.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_arousal.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:anger|>`})}),_jsx(_components.td,{children:`Anger`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:anger|>How dare you do that to me, this is completely unacceptable!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_anger.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:fear|>`})}),_jsx(_components.td,{children:`Fear`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:fear|>Did you hear that? Something is out there, I'm really scared.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_fear.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:disgust|>`})}),_jsx(_components.td,{children:`Disgust`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:disgust|>Ugh, that is absolutely revolting, I can't even look at it.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_disgust.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:bitterness|>`})}),_jsx(_components.td,{children:`Bitterness`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:bitterness|>After everything I did for them, this is how they repay me.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_bitterness.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:sadness|>`})}),_jsx(_components.td,{children:`Sadness`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:sadness|>I really thought things would be different, it hurts so much.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_sadness.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:shame|>`})}),_jsx(_components.td,{children:`Shame`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:shame|>I can't believe I did that, I'm so embarrassed and ashamed.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_shame.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:helplessness|>`})}),_jsx(_components.td,{children:`Helplessness`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:helplessness|>There's nothing I can do anymore, I just feel so powerless.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/emotion_helplessness.mp3`})})]})]})]}),_jsx(Heading,{level:`2`,id:`style`,children:`Style`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tag`}),_jsx(_components.th,{children:`Effect`}),_jsx(_components.th,{children:`Sample input`}),_jsx(_components.th,{children:`Sample audio`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|style:singing|>`})}),_jsx(_components.td,{children:`Singing`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|style:singing|>Dancing in the rain, feeling so alive again.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/style_singing.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|style:shouting|>`})}),_jsx(_components.td,{children:`Shouting / projected voice`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|style:shouting|>Hey! Over here! Everybody listen to me right now!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/style_shouting.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|style:whispering|>`})}),_jsx(_components.td,{children:`Whisper`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|style:whispering|>Lean in, I have a little secret just for you, don't tell anyone.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/style_whispering.mp3`})})]})]})]}),_jsx(Heading,{level:`2`,id:`sound-effects`,children:`Sound effects`}),_jsx(_components.p,{children:`Sound effects are vocalized — produced in the speaker’s voice — not mixed-in audio assets.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tag`}),_jsx(_components.th,{children:`Effect`}),_jsx(_components.th,{children:`Sample input`}),_jsx(_components.th,{children:`Sample audio`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:cough|>`})}),_jsx(_components.td,{children:`Cough`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:cough|>Ahem, could I have everyone's attention, please?`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/sfx_cough.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:laughter|>`})}),_jsx(_components.td,{children:`Laughter`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:laughter|>Haha, that's the funniest thing I've heard all day!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/sfx_laughter.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:crying|>`})}),_jsx(_components.td,{children:`Crying`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:sadness|>\u003c|sfx:crying|>I... I’m sorry.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/sfx_crying.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:screaming|>`})}),_jsx(_components.td,{children:`Screaming`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:screaming|>Ah, no, no, this can't be happening!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/sfx_screaming.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:burping|>`})}),_jsx(_components.td,{children:`Burping`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:burping|>Burp—ugh, whoa, sorry, that one snuck up on me.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/sfx_burping.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:humming|>`})}),_jsx(_components.td,{children:`Humming`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:humming|>Hmm, that's a tricky question, isn't it?`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/sfx_humming.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:sigh|>`})}),_jsx(_components.td,{children:`Sigh`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:sigh|>Ahh, well, there's nothing left to do but wait.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/sfx_sigh.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:sniff|>`})}),_jsx(_components.td,{children:`Sniff`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:sniff|>Sff..., it's so cold out, my nose won't stop.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/sfx_sniff.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:sneeze|>`})}),_jsx(_components.td,{children:`Sneeze`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|sfx:sneeze|>Achoo! Bless you, oh wait, that was me.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/sfx_sneeze.mp3`})})]})]})]}),_jsx(Heading,{level:`2`,id:`prosody`,children:`Prosody`}),_jsx(_components.p,{children:`Prosody tags control speed, pitch, pauses, and overall expressiveness.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tag`}),_jsx(_components.th,{children:`Effect`}),_jsx(_components.th,{children:`Sample input`}),_jsx(_components.th,{children:`Sample audio`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:speed_very_slow|>`})}),_jsx(_components.td,{children:`~0.65× speed`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:speed_very_slow|>Take your time, \u003c|prosody:pause|> there is, \u003c|prosody:pause|> really no need \u003c|prosody:pause|> to rush \u003c|prosody:pause|> at all.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/prosody_speed_very_slow.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:speed_slow|>`})}),_jsx(_components.td,{children:`~0.85× speed`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:speed_slow|>Let me explain this slowly, so everyone can follow along.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/prosody_speed_slow.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:speed_fast|>`})}),_jsx(_components.td,{children:`~1.2× speed`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:speed_fast|>Quick, quick, we have to go right now, we're running late!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/prosody_speed_fast.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:speed_very_fast|>`})}),_jsx(_components.td,{children:`~1.4× speed`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:speed_very_fast|>Wait wait wait, two minutes till the train, no time to talk, just run run, go go go!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/prosody_speed_very_fast.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:pitch_low|>`})}),_jsx(_components.td,{children:`~−3 semitones`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:pitch_low|>In a deep and serious voice, he delivered the grave news.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/prosody_pitch_low.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:pitch_high|>`})}),_jsx(_components.td,{children:`~+2.5 semitones`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:pitch_high|>Oh hello there little one, aren't you just the cutest!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/prosody_pitch_high.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:pause|>`})}),_jsx(_components.td,{children:`~400–700 ms pause`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Wait for it \u003c|prosody:pause|> and there it is, the big reveal.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/prosody_pause.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:long_pause|>`})}),_jsx(_components.td,{children:`~700–1500 ms pause`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`I have something important to tell you. \u003c|prosody:long_pause|> I'm leaving tomorrow.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/prosody_long_pause.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:expressive_high|>`})}),_jsx(_components.td,{children:`More expressive delivery`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:expressive_high|>This is incredible, absolutely magnificent, beyond my wildest dreams!`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/prosody_expressive_high.mp3`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:expressive_low|>`})}),_jsx(_components.td,{children:`Flatter delivery`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|prosody:expressive_low|>The meeting is at noon. Bring your reports. That's all.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/prosody_expressive_low.mp3`})})]})]})]}),_jsx(Heading,{level:`2`,id:`other`,children:`Other`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tag`}),_jsx(_components.th,{children:`Effect`}),_jsx(_components.th,{children:`Sample input`}),_jsx(_components.th,{children:`Sample audio`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|reset|>`})}),_jsx(_components.td,{children:`Resets to neutral delivery`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`\u003c|emotion:sadness|>\u003c|prosody:speed_slow|>She waited by the window every night, hoping he would come home. But the seasons changed, the years went by, and he never did. \u003c|reset|>That concludes chapter three. Chapter four begins on the next page.`})}),_jsx(_components.td,{children:_jsx(`audio`,{controls:true,src:`/public/audio/higgs-audio-tts-tags/other_reset.mp3`})})]})})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Tags","description":"Inline control tokens that shape emotion, style, prosody, and sound effects inside the input text.","href":"/models/higgs-tts/tags"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Emotion","slug":"emotion","depth":2,"children":[]},{"title":"Style","slug":"style","depth":2,"children":[]},{"title":"Sound effects","slug":"sound-effects","depth":2,"children":[]},{"title":"Prosody","slug":"prosody","depth":2,"children":[]},{"title":"Other","slug":"other","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"bosonai","siteName":"Boson","title":"Tags - Boson","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T22:05:00.422Z","originalFileLocation":"models/higgs-tts/tags.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Inline control tokens that shape emotion, style, prosody, and sound effects inside the input text.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Boson\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bosonai/3o-utK_tG8ZQHECF/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bosonai/3o-utK_tG8ZQHECF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bosonai/3o-utK_tG8ZQHECF/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bosonai/3o-utK_tG8ZQHECF/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bosonai/3o-utK_tG8ZQHECF/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bosonai/3o-utK_tG8ZQHECF/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bosonai/3o-utK_tG8ZQHECF/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bosonai/3o-utK_tG8ZQHECF/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bosonai/3o-utK_tG8ZQHECF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Tags - Boson\">\u003cmeta data-mint-head property=\"og:description\" content=\"Inline control tokens that shape emotion, style, prosody, and sound effects inside the input text.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Boson\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.boson.ai/models/higgs-tts/tags\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bosonai.mintlify.site/_mintlify/api/og/v2?division=Higgs+TTS+3\u0026amp;title=Tags\u0026amp;description=Inline+control+tokens+that+shape+emotion%2C+style%2C+prosody%2C+and+sound+effects+inside+the+input+text.\u0026amp;theme=018ed43312581b1861d7483a\u0026amp;signature=8fcd14d0b946df5e1034200c1945992a007c375c64e54675969eddf74ca971f1\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Tags - Boson\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Inline control tokens that shape emotion, style, prosody, and sound effects inside the input text.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bosonai.mintlify.site/_mintlify/api/og/v2?division=Higgs+TTS+3\u0026amp;title=Tags\u0026amp;description=Inline+control+tokens+that+shape+emotion%2C+style%2C+prosody%2C+and+sound+effects+inside+the+input+text.\u0026amp;theme=018ed43312581b1861d7483a\u0026amp;signature=8fcd14d0b946df5e1034200c1945992a007c375c64e54675969eddf74ca971f1\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bosonai/3o-utK_tG8ZQHECF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Boson\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#17B726\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.boson.ai/models/higgs-tts/tags\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/models/higgs-tts/tags.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.boson.ai/#organization\",\"name\":\"Boson\",\"url\":\"https://docs.boson.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bosonai/nle8KC3HRTUuBQvw/public/images/boson_ai_logo.svg?fit=max\u0026auto=format\u0026n=nle8KC3HRTUuBQvw\u0026q=85\u0026s=a612c3151ec7dfaae986ba9f8053392b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.boson.ai#website\",\"name\":\"Boson\",\"url\":\"https://docs.boson.ai\",\"publisher\":{\"@id\":\"https://docs.boson.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.boson.ai/models/higgs-tts/tags#webpage\",\"url\":\"https://docs.boson.ai/models/higgs-tts/tags\",\"name\":\"Tags\",\"description\":\"Inline control tokens that shape emotion, style, prosody, and sound effects inside the input text.\",\"dateModified\":\"2026-11-12T22:05:00.422Z\",\"isPartOf\":{\"@id\":\"https://docs.boson.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.boson.ai/models/higgs-tts/tags#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.boson.ai/models/higgs-tts/tags#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Higgs TTS 3\",\"item\":\"https://docs.boson.ai/models/higgs-tts/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tags\",\"item\":\"https://docs.boson.ai/models/higgs-tts/tags\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.boson.ai/models/higgs-tts/tags#article\",\"headline\":\"Tags\",\"name\":\"Tags\",\"description\":\"Inline control tokens that shape emotion, style, prosody, and sound effects inside the input text.\",\"url\":\"https://docs.boson.ai/models/higgs-tts/tags\",\"mainEntityOfPage\":{\"@id\":\"https://docs.boson.ai/models/higgs-tts/tags#webpage\"},\"dateModified\":\"2026-11-12T22:05:00.422Z\",\"publisher\":{\"@id\":\"https://docs.boson.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.boson.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Boson\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Boson\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/models/higgs-tts/tags.md","siteName":"Boson","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"Welcome to Boson AI","href":"/overview"},{"title":"Set up your account","href":"/set-up-your-account"},{"title":"Free trial credit","href":"/free-trial-credit"},{"title":"Authentication","href":"/authentication"},{"title":"Custom voices and avatars","href":"/custom-voices-and-avatars"},{"title":"Pricing","href":"/pricing"}]},{"group":"Account \u0026 billing","pages":[{"title":"Payment \u0026 credits","href":"/account-billing/payment-and-credits"},{"title":"Usage \u0026 limits","href":"/account-billing/usage-and-limits"}]},{"group":"Higgs Realtime","pages":[{"title":"Overview","href":"/models/higgs-realtime/overview"},{"title":"Quickstart","href":"/models/higgs-realtime/quickstart"},{"group":"Guides","pages":[{"title":"Connections and sessions","href":"/models/higgs-realtime/guides/connections-and-sessions"},{"title":"Audio and voices","href":"/models/higgs-realtime/guides/audio-and-voices"},{"title":"Turn detection and interruptions","href":"/models/higgs-realtime/guides/turn-detection-and-interruptions"},{"title":"Tool use","href":"/models/higgs-realtime/guides/tool-calling"}]},{"group":"Integrations","pages":[{"title":"Migrate an existing integration","href":"/models/higgs-realtime/migrate-an-existing-integration"},{"title":"LiveKit","href":"/models/higgs-realtime/integrations/livekit"},{"title":"Pipecat","href":"/models/higgs-realtime/integrations/pipecat"}]}]},{"group":"Higgs TTS 3","pages":[{"title":"Overview","href":"/models/higgs-tts/overview"},{"title":"Voices","href":"/models/higgs-tts/voices"},{"title":"Languages","description":"Higgs TTS 3 supports 102 languages with single-digit WER/CER.","href":"/models/higgs-tts/languages"},{"title":"Tags","href":"/models/higgs-tts/tags"},{"title":"Streaming TTS","description":"Stream speech from a single request, or send text as it arrives and hear audio over the speech WebSocket.","href":"/models/higgs-tts/streaming"},{"title":"Timestamps","href":"/models/higgs-tts/timestamps"},{"title":"Migrate from OpenAI TTS","href":"/models/higgs-tts/openai-compatible"}]},{"group":"Higgs Avatar","pages":[{"title":"Overview","href":"/models/higgs-avatar/overview"},{"title":"Inputs and limits","href":"/models/higgs-avatar/input-options"},{"title":"Streaming video","href":"/models/higgs-avatar/streaming-video"},{"title":"Realtime sessions","href":"/models/higgs-avatar/realtime-sessions"}]},{"group":"Help","pages":[{"title":"Report issues and share feedback","sidebarTitle":"Feedback","href":"/feedback"},{"title":"Problem with your account","sidebarTitle":"Account support","href":"/account-support"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/realtime/overview"}]}]},"basePath":"","title":"Tags - Boson","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":[],"chunks":[]}
