How to Use Zonos2 in Claude
Zonos2 turns scripts into multilingual speech with natural voice cloning, for narration, spoken updates, and dialogue previews. Its accuracy mode favors a closer voice match; switching it off allows more expression.
Prompts to try with Zonos2 in Claude
Copy an example into Claude, or ask in your own words.
Write a 70-word welcome message for a neighborhood gardening workshop, then read it with Zonos2 using my supplied voice reference. Prioritize a close voice match.
Prepare English and Japanese versions of a two-sentence museum welcome. Generate each separately with Zonos2 using my supplied voice reference, and show me both scripts.
Use Zonos2 to read this exact line twice with my supplied voice reference: 'You came back. I thought I had missed my chance.' Prioritize voice accuracy for the first reading and expression for the second.
Create a short English explanation of the Mandarin greeting 你好, including the greeting in Mandarin, and generate it with Zonos2. Keep the script below 50 words and show the text before the recording.
Shorten my announcement to 80 words, spell out dates and numbers as they should be spoken, and generate it with Zonos2 using my supplied voice reference.
How to set up Zonos2 in Claude
Pick the way that suits you. Each takes about two minutes.
Use the Claude connector
- Add Spiral to Claude
Click Add Spiral in Claude above. Claude opens Add custom connector with Spiral and its URL filled in; check them and click Continue. Without the link: in Claude open Customize › Connectors › Add › Add custom connector and paste this URL:
https://api.spiral.ai/mcp
- Keep the detected sign-in and click Add
Claude finds Spiral's sign-in by itself: leave Sign in now and Use Claude's published identity selected.
- Click Connect
The connector page opens. Connect takes you to Spiral in your browser.
Use the Spiral skill
- Send Claude this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Zonos2
One request; the result comes back by polling or a webhook.
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/zonos2", "input": { "reference_audio_url": "https://storage.googleapis.com/falserverless/model_tests/zonos/demo_voice_zonos.wav" } }'
Then paste one of the prompts above: Claude finds Zonos2 on Spiral, shows the price and runs it.
Zonos2 providers and prices
Spiral runs Zonos2 through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Claude for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Seed | 0 to 2147483647 | Seed for reproducibility. Random when omitted. | |
| Accurate mode | on or off | on | True = closer voice match; False = more expressive. |
| Clean speaker background | on or off | off | Mark the reference audio as having a clean background. |
| Temperature | 0 to 2 | 1.15 | Sampling temperature. |
| Top p | 0 to 1 | 0 | Nucleus sampling probability (0 disables). |
| Min p | 0 to 1 | 0.18 | Minimum-probability sampling threshold. |
| Top k | 0 to 2048 | 106 | Top-k sampling cutoff (0 disables). |
| Max tokens | 1 to 6144 | Maximum number of audio frames to generate. Defaults to the model context limit. |
Every API field of Zonos2 Text to Speech is on its tool page: open its card above.
What can you do with Zonos2 in Claude?
Turn an approved script into narration or a multilingual voice recording with Zonos2. A chat agent can shorten the text for a one-minute passage and help compare voice accuracy with expression.
Product walkthrough narration
Turn a short walkthrough script into speech with Zonos2. Generate each section separately so you can replace a line when the product changes.
Multilingual announcements
Produce separate English, Mandarin Chinese, and Japanese readings of an approved announcement with Zonos2. Review each language before distributing the recordings.
Dialogue auditions
Use Zonos2 to audition short fictional dialogue with accuracy mode on and off. Compare voice resemblance and expression before choosing a reading.
Audio learning cards
Create spoken examples for vocabulary cards with Zonos2. Keep each card to a short sentence and check pronunciation before adding it to a lesson.
Daily spoken briefings
Convert a concise daily summary into a Zonos2 recording under one minute. Prepare the summary first, then synthesize only the approved spoken text.
Podcast intros and corrections
Generate a short introduction or replacement passage with Zonos2 using the host's supplied voice reference. Listen for differences in recording texture before editing it into an episode.
Bilingual explanations
Use Zonos2 to read a short explanation that switches between languages, such as an English lesson containing Mandarin examples. Check the words around each language change.
More on Zonos2 and Claude
Overview
Zonos2 in other agents
Questions about Zonos2 in Claude
Can Claude use Zonos2?
Yes. Add Spiral to Claude as an MCP server, and Claude can find and run Zonos2 like any built-in tool.
How much does Zonos2 cost in Claude?
Up to $0.013 per run at the default inputs for 60 seconds of input. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude plan is separate.
Do I need a fal account to use Zonos2 in Claude?
No. Spiral runs Zonos2 on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Zonos2 in Claude?
About two minutes: add Spiral to Claude, then keep the detected sign-in and click Add, then click Connect.
Does Claude wait while Zonos2 runs?
Zonos2 runs in the background. Claude starts the run, checks on it and gives you the audio when it's ready.
What is Zonos2 best used for?
Zonos2 suits spoken content where the sound of a particular voice matters: short narration, dialogue previews, and multilingual announcements. It can clone a voice from a short sample.
How long can a Zonos2 clip be?
Zyphra documents generation up to one minute. For longer narration, split the script into separate passages and review the joins.
Which languages should I try first?
English, Mandarin Chinese, and Japanese occupy Zyphra's highest support tier. French, Spanish, German, and several other languages are supported in a lower tier, so audition your actual script before committing to a batch.
Should I prioritize voice accuracy or expression?
Keep accuracy mode on when matching the reference voice matters most. Try it off for a more expressive reading, then compare both recordings with the same script.
Will Zonos2 clean up a noisy voice reference?
Do not assume it will remove every imperfection. Zyphra emphasizes vocal fidelity even with noisy or distorted references; choose a clean recording when clean narration is the goal.
Start using Zonos2 in Claude
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude:
set up https://spiral.ai/SKILL.md


