Spiral gives your agent every tool with one account. Browse the tools →

VS Code · AudioReleased 2026-06-12

How to Use Zonos2 in VS Code

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 VS Code

Copy an example into VS Code, or ask in your own words.

Read README.md and draft a 60-word spoken introduction to this project. Generate it with Zonos2 using my supplied voice reference and accurate_mode=true, then save the script beside the audio.

Zonos2VS Code
Try asking
  • Use the onboarding copy in this project to create three short narration passages with Zonos2. Keep each passage under one minute and save them in onboarding order.

  • Find the approved English and Japanese tutorial strings in the project. Generate a separate Zonos2 recording for each language and flag any names that need a pronunciation check.

  • Take the first dialogue line in dialogue.json and generate two Zonos2 readings with the same reference and seed: one with accurate_mode=true and one with accurate_mode=false. Label them for listening review.

  • Turn CHANGELOG.md's latest entry into a 70-word release narration and generate it with Zonos2. Expand version numbers into the words a listener should hear and save the final spoken script.

How to set up Zonos2 in VS Code

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

Use Spiral's MCP server

  1. Add the hosted server

    Use Add to VS Code on the console's Agents & MCP page, or run:

    code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
  2. Sign in

    VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

Use the Spiral skill

  1. Send VS Code 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 the Spiral CLI

  1. 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

  1. Create an API key

    In the console, under API keys.

  2. 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: VS Code 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.

falAudio

Settings you can ask for

Ask VS Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seed0 to 2147483647

Seed for reproducibility. Random when omitted.

Accurate modeon or offon

True = closer voice match; False = more expressive.

Clean speaker backgroundon or offoff

Mark the reference audio as having a clean background.

Temperature0 to 21.15

Sampling temperature.

Top p0 to 10

Nucleus sampling probability (0 disables).

Min p0 to 10.18

Minimum-probability sampling threshold.

Top k0 to 2048106

Top-k sampling cutoff (0 disables).

Max tokens1 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 VS Code?

Add spoken walkthroughs, dialogue auditions, and multilingual audio assets to a project with Zonos2. A coding agent can prepare scripts from project files and organize separate passages for review.

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.

Questions about Zonos2 in VS Code

Can VS Code use Zonos2?

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Zonos2 like any built-in tool.

How much does Zonos2 cost in VS Code?

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 VS Code plan is separate.

Do I need a fal account to use Zonos2 in VS Code?

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 VS Code?

About two minutes: add the hosted server, then sign in.

Does VS Code wait while Zonos2 runs?

Zonos2 runs in the background. VS Code 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.

Get started

Start using Zonos2 in VS Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into VS Code:

Set up VS Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options