[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [Chatterbox Multilingual](https://spiral.ai/integrations/hermes/chatterbox-multilingual)

# How to Use Chatterbox Multilingual in Hermes

Chatterbox Multilingual turns scripts into speech in 23 languages and can copy a reference speaker's voice and delivery. It suits localized narration and character dialogue, with expressiveness and guidance controls for tuning delivery.

|  |  |
| --- | --- |
| Model | Chatterbox Multilingual |
| Available through | fal |
| Category | Audio |
| Price | Each item in `text` adds $0.0325. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Chatterbox Multilingual in Hermes

- Every weekday morning, use Chatterbox Multilingual to narrate a three-sentence summary of my calendar. Generate one clip per sentence and include the written summary.
- Every evening, use Chatterbox Multilingual to create three short listening exercises from the vocabulary we practiced that day. Keep each exercise in a separate clip.
- Every Friday, use Chatterbox Multilingual to turn the week's approved product updates into short tutorial voiceovers. Keep each update as a separate clip for review.
- Each morning, use Chatterbox Multilingual to narrate my three highest-priority tasks. Keep each task to one sentence and create a separate audio clip for it.
- Every Monday, use Chatterbox Multilingual to prepare a short audio recap of the previous week's approved announcements. Generate separate sections and include a checklist for reviewing pronunciation and joins.

## How to set up Chatterbox Multilingual in Hermes

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Hermes this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Chatterbox Multilingual**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/chatterbox/text-to-speech/multilingual",
    "input": {
      "text": "Last month, we reached a new milestone with two billion views on our YouTube channel."
    }
  }'
```

Then paste one of the prompts above: Hermes finds Chatterbox Multilingual on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/hermes

## Chatterbox Multilingual tools and prices

- [Chatterbox](https://spiral.ai/tools/fal/fal-ai/chatterbox/text-to-speech/multilingual) (fal): $0.0325 per 1,000 characters of `text`. Rounded up to the next 1,000 characters, minimum 1,000.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| voice |  | english | Language code for synthesis. In case using custom please provide audio url and select custom_audio_language. |
| custom_audio_language | english, arabic, danish, german, greek, spanish, finnish, french, hebrew, hindi, italian, japanese, korean, malay, dutch, norwegian, polish, portuguese, russian, swedish, swahili, turkish, chinese | — | If using a custom audio URL, specify the language of the audio here. Ignored if voice is not a custom url. |
| exaggeration | 0.25 to 2 | 0.5 | Controls speech expressiveness and emotional intensity (0.25-2.0). 0.5 is neutral, higher values increase expressiveness. Extreme values may be unstable. |
| temperature | 0.05 to 2 | 0.8 | Controls randomness and variation in generation (0.05-2.0). Higher values create more varied speech patterns. |
| cfg_scale | 0 to 1 | 0.5 | Configuration/pace weight controlling generation guidance (0.0-1.0). Use 0.0 for language transfer to mitigate accent inheritance. |
| seed |  | — | Random seed for reproducible results. Set to 0 for random generation, or provide a specific number for consistent outputs. |

## What can you do with Chatterbox Multilingual in Hermes?

Produce recurring spoken briefings and learning clips with Chatterbox Multilingual. An always-on agent can prepare short scripts on a schedule and collect the audio for review.

### Localized video narration

Create separate spoken tracks from translated scripts. Use reference audio to guide the narrator's voice and delivery.

### Game character dialogue

Generate individual character lines and audition emotional delivery with expressiveness around 0.7 and guidance around 0.3.

### Spoken assistant responses

Turn written assistant replies into speech, using a reference voice to guide how the assistant sounds.

### Product tutorial voiceovers

Produce one spoken instruction per tutorial step. If a reference voice sounds rushed, audition lower guidance before recording the remaining steps.

### Language practice clips

Create short listening exercises from prepared sentences. Match the reference recording to the target language to reduce unwanted accent carryover.

### Recurring audio briefings

Convert approved updates into short narrated sections. Review the joins before combining them into a longer briefing.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Hermes guides](https://spiral.ai/integrations/hermes)

## Chatterbox Multilingual in other agents

- [Amp](https://spiral.ai/integrations/amp/chatterbox-multilingual)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/chatterbox-multilingual)
- [Claude](https://spiral.ai/integrations/claude-desktop/chatterbox-multilingual)
- [Claude Code](https://spiral.ai/integrations/claude-code/chatterbox-multilingual)
- [Cline](https://spiral.ai/integrations/cline/chatterbox-multilingual)
- [Codex](https://spiral.ai/integrations/codex/chatterbox-multilingual)
- [Cursor](https://spiral.ai/integrations/cursor/chatterbox-multilingual)
- [Devin](https://spiral.ai/integrations/devin/chatterbox-multilingual)
- [dots](https://spiral.ai/integrations/dots/chatterbox-multilingual)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/chatterbox-multilingual)
- [Gemini](https://spiral.ai/integrations/gemini/chatterbox-multilingual)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/chatterbox-multilingual)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/chatterbox-multilingual)
- [goose](https://spiral.ai/integrations/goose/chatterbox-multilingual)
- [Grok](https://spiral.ai/integrations/grok/chatterbox-multilingual)
- [Grok Build](https://spiral.ai/integrations/grok-build/chatterbox-multilingual)
- [Instinct](https://spiral.ai/integrations/instinct/chatterbox-multilingual)
- [Manus](https://spiral.ai/integrations/manus/chatterbox-multilingual)
- [Muse](https://spiral.ai/integrations/muse/chatterbox-multilingual)
- [Muse Code](https://spiral.ai/integrations/muse-code/chatterbox-multilingual)
- [n8n](https://spiral.ai/integrations/n8n/chatterbox-multilingual)
- [Notion](https://spiral.ai/integrations/notion/chatterbox-multilingual)
- [OpenClaw](https://spiral.ai/integrations/openclaw/chatterbox-multilingual)
- [opencode](https://spiral.ai/integrations/opencode/chatterbox-multilingual)
- [Perplexity](https://spiral.ai/integrations/perplexity/chatterbox-multilingual)
- [Raycast](https://spiral.ai/integrations/raycast/chatterbox-multilingual)
- [VS Code](https://spiral.ai/integrations/vscode/chatterbox-multilingual)
- [Windsurf](https://spiral.ai/integrations/windsurf/chatterbox-multilingual)
- [Zapier](https://spiral.ai/integrations/zapier/chatterbox-multilingual)

## More Hermes guides

- [Chatterbox HD Speech to Speech](https://spiral.ai/integrations/hermes/chatterbox-hd-speech-to-speech)
- [Chatterbox Speech to Speech](https://spiral.ai/integrations/hermes/chatterbox-speech-to-speech)
- [Chatterbox HD](https://spiral.ai/integrations/hermes/chatterbox-hd)
- [Chatterbox TTS](https://spiral.ai/integrations/hermes/chatterbox-tts)
- [CassetteAI Sound Effects Generator](https://spiral.ai/integrations/hermes/cassetteai-sound-effects-generator)
- [Cohere Transcribe](https://spiral.ai/integrations/hermes/cohere-transcribe)

## Questions about Chatterbox Multilingual in Hermes

**Can Hermes use Chatterbox Multilingual?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Chatterbox Multilingual like any built-in tool.

**How much does Chatterbox Multilingual cost in Hermes?**

Each item in `text` adds $0.0325. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.

**Do I need a fal account to use Chatterbox Multilingual in Hermes?**

No. Spiral runs Chatterbox Multilingual on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Chatterbox Multilingual in Hermes?**

About two minutes: add the server and sign in, then check it.

**Does Hermes wait while Chatterbox Multilingual runs?**

Chatterbox Multilingual runs in the background. Hermes starts the run, checks on it and gives you the audio when it's ready.

**What is Chatterbox Multilingual useful for?**

Use it for localized narration, spoken responses, and character dialogue. Its reference audio conditioning lets you carry a speaker's voice and delivery into generated speech.

**Can Chatterbox Multilingual reproduce a reference voice?**

Yes. A reference recording supplies voice characteristics and speaking style, including the speaker's tone and prosody.

**Why does speech inherit an accent from another language?**

Cross-language generation can carry over the reference recording's accent. Use a reference in the target language, or try setting guidance to zero to reduce that carryover.

**How do I adjust pacing and emotional delivery?**

For a rushed reference voice, try guidance around 0.3. For dramatic delivery, the maker suggests combining guidance around 0.3 with expressiveness around 0.7 or higher.

**What audio quality does Chatterbox Multilingual produce?**

The model card describes 24 kHz mono audio in 16-bit PCM WAV format. That is a single audio channel.

