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

Factory Droid · AudioReleased 2024-10-08

How to Use F5-TTS in Factory Droid

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 Factory Droid

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

Read the onboarding guide in this project and write three short narration passages. Generate each with F5-TTS using my reference recording, keeping each passage around 10 seconds.

F5-TTSFactory Droid
Try asking
  • Use F5-TTS to create spoken drafts of the game's first five dialogue lines. Use the supplied character reference recordings and generate each line separately.

  • Turn the latest release notes in this repository into a two-sentence spoken announcement with F5-TTS. Use my reference recording and keep the script around 10 seconds.

  • Create English and Chinese readings of the project's welcome message with F5-TTS. Use my reference recording, keep each reading short, and save them as separate audio assets.

  • Use F5-TTS to audition two readings of the tutorial introduction: one with a comma before the final phrase and one with a period. Keep the words and reference recording identical.

How to set up F5-TTS in Factory Droid

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

Use Spiral's MCP server

  1. Add the server

    Droid saves it to your user config, ~/.factory/mcp.json, so it works in every project.

    droid mcp add spiral https://api.spiral.ai/mcp --type http
  2. Sign in

    Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

  3. Check it

    Spiral shows as connected. needs authentication means the sign-in did not finish: run /mcp again.

    droid mcp list

Use the Spiral skill

  1. Send Factory Droid 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: Factory Droid 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 Factory Droid 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 Factory Droid?

Add spoken tutorials, demo narration, and dialogue drafts to your project with F5-TTS. A coding agent can turn project text into short spoken passages and reuse a reference recording across them.

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 Factory Droid

Can Factory Droid use F5-TTS?

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

How much does F5-TTS cost in Factory Droid?

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 Factory Droid plan is separate.

Do I need a fal account to use F5-TTS in Factory Droid?

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 Factory Droid?

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

Does Factory Droid wait while F5-TTS runs?

F5-TTS runs in the background. Factory Droid 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 Factory Droid

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

Paste this into Factory Droid:

Set up Factory Droid

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