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

Claude · AudioReleased 2024-10-08

How to Use F5-TTS in Claude

F5-TTS turns written scripts into speech guided by a reference voice. Use it for English or Chinese narration, including scripts that switch between the two languages.

Prompts to try with F5-TTS in Claude

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

Use F5-TTS and my reference recording to say: 'Welcome back. Today, we will practice asking for directions.' Keep the pause after the first sentence.

F5-TTSClaude
Try asking
  • Write a short English and Chinese greeting, then read it with F5-TTS using my reference recording. Keep the entire greeting around 10 seconds.

  • Use F5-TTS to read: 'The rain had stopped. Beyond the gate, someone was waiting.' Use my calm reference recording and keep the script exactly as written.

  • Turn my explanation above into two short spoken instructions with F5-TTS. Use my reference recording and generate each instruction separately.

  • Use F5-TTS to read 'Your lesson is ready. Take a breath, and begin.' twice with the same reference recording. In the second script, replace the comma with a period so I can compare the pauses.

How to set up F5-TTS in Claude

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

Use the Claude connector

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

  3. Click Connect

    The connector page opens. Connect takes you to Spiral in your browser.

Use the Spiral skill

  1. Send Claude 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 F5-TTS

    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/f5-tts",
        "input": {
          "gen_text": "I don'\''t really care what you call me. I'\''ve been a silent spectator, watching species evolve, empires rise and fall. But always remember, I am mighty and…",
          "ref_audio_url": "https://storage.googleapis.com/falserverless/example_inputs/reference_audio.wav",
          "model_type": "F5-TTS"
        }
      }'

Then paste one of the prompts above: Claude finds F5-TTS on Spiral, shows the price and runs it.

F5-TTS providers and prices

Spiral runs F5-TTS through fal. Open a card for today's price, with every fee included.

falAudio
F5 TTS
fal-ai/f5-tts

Settings you can ask for

Ask Claude for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Model typeF5-TTS or E2-TTS

The name of the model to be used for TTS.

Remove silenceon or offon

Whether to remove the silence from the audio file.

Every API field of F5 TTS is on its tool page: open its card above.

What can you do with F5-TTS in Claude?

Hear a written message, lesson, or story passage in a reference voice with F5-TTS. A chat app can help shape the spoken script and mark pauses before generating a short reading.

Tutorial narration

Turn short tutorial scripts into spoken instructions with F5-TTS, using the same reference voice for each passage.

English and Chinese lesson audio

Create separate spoken examples in English and Chinese with F5-TTS. Include mixed-language examples when a lesson needs both languages in one passage.

Daily spoken briefings

Read a short daily summary with F5-TTS in a recurring reference voice. Divide longer summaries into separate passages.

Game dialogue drafts

Audition short character lines with F5-TTS using reference recordings chosen for each character's voice and emotional delivery.

Narration revisions

Generate revised sentences with F5-TTS using the original reference voice, then review them alongside the surrounding narration.

Spoken product announcements

Create short announcement readings with F5-TTS. Use punctuation to test where the speaker pauses between the news and the next action.

Story readings

Prepare short story passages for F5-TTS and select reference speech that matches the intended mood. Review each passage before assembling a longer reading.

Questions about F5-TTS in Claude

Can Claude use F5-TTS?

Yes. Add Spiral to Claude as an MCP server, and Claude can find and run F5-TTS like any built-in tool.

How much does F5-TTS cost in Claude?

Each item in `gen_text` adds $0.065. 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 F5-TTS in Claude?

No. Spiral runs F5-TTS on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up F5-TTS 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 F5-TTS runs?

F5-TTS runs in the background. Claude starts the run, checks on it and gives you the audio when it's ready.

What is F5-TTS useful for?

F5-TTS suits spoken scripts that should follow a reference voice, such as tutorial narration, lesson audio, and short announcements. The reference guides the speaker characteristics; your script supplies the words.

Which languages does F5-TTS support?

The official checkpoints support English and Chinese. The maker also demonstrates switching between those languages within speech.

How long should the reference recording be?

The maker recommends a reference clip shorter than 12 seconds. Choose a short excerpt that represents the voice you want to hear.

Can F5-TTS narrate a long script?

Plan longer narration as separate passages. The official inference documentation gives a 30-second limit for one generation, including reference audio, so that is not a full 30 seconds of new speech.

How do I add pauses to F5-TTS speech?

Use punctuation and spaces in the spoken script to mark pauses. Start with short sentences, then listen to the result before adjusting the punctuation.

Get started

Start using F5-TTS in Claude

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

Paste this into Claude:

Set up Claude

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