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

Factory Droid · AudioReleased 2025-12-30

How to Use SAM Audio in Factory Droid

Use SAM Audio to extract speech, instruments, or sound effects from a mixed recording by describing the sound. It returns the requested sound and a separate track containing everything else.

Prompts to try with SAM Audio in Factory Droid

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

Use SAM Audio on assets/interview.wav with the sound description 'speech'. Save both returned tracks beside the original and add an original-versus-extracted playback comparison to our review page.

SAM AudioFactory Droid
Try asking
  • Use SAM Audio on assets/street.wav to extract 'car honking' with automatic span prediction enabled. Add the extracted sound and remaining audio to the project's listening review.

  • Use SAM Audio on assets/piano-mix.wav to extract 'piano playing'. Run one comparison with automatic span prediction enabled and one disabled, and prepare both for listening.

  • Use SAM Audio on assets/podcast.wav to extract 'dog barking'. Put the remaining-audio track in the podcast edit folder and retain the extracted barking for comparison.

  • Use SAM Audio on assets/song.wav to extract 'singing voice' with three reranking candidates. Save both returned tracks and add a review note asking the editor to check vocal bleed.

How to set up SAM Audio 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 SAM Audio

    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/sam-audio/separate",
        "input": {
          "audio_url": "https://v3b.fal.media/files/b/0a88511f/tUUCI9eDmeC2RqJEOXrZk_assets_avatar_multi_sing_woman.WAV",
          "prompt": "piano playing"
        }
      }'

Then paste one of the prompts above: Factory Droid finds SAM Audio on Spiral, shows the price and runs it.

SAM Audio providers and prices

Spiral runs SAM Audio through fal. Open a card for today's price, with every fee included.

falAudio

Settings you can ask for

SAM Audio works from your audio URL and prompt. Ask Factory Droid for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Predict spanson or offoff

Automatically predict temporal spans where the target sound occurs.

Reranking candidates1 to 71

Number of candidates to generate and rank. Higher improves quality but increases latency and cost.

Accelerationfast, balanced, or qualitybalanced

The acceleration level to use.

Max chunk duration10 to 6060

Maximum audio duration (in seconds) to process in a single pass. Longer audio will be chunked with overlap and blended.

Chunk overlap0 to 305

Overlap duration (in seconds) between chunks for crossfade blending.

Output formatwav or mp3wav

Output audio format.

Every API field of SAM Audio · Text-Prompted Sound Separation is on its tool page: open its card above.

What can you do with SAM Audio in Factory Droid?

Extract dialogue, music parts, and sound effects from recordings used in your project. A coding agent can organize the target and remaining-audio tracks into an editing workflow and prepare comparisons for review.

Prepare interview dialogue

Extract speech from a noisy interview recording for a dialogue edit. Compare the extracted speech with the original before replacing the source track.

Remove barking from a podcast

Target the barking and use the remaining-audio track as a podcast editing candidate. Check the moments where barking overlaps speech.

Reduce traffic in outdoor recordings

Separate traffic noise from recorded outdoor audio, then review the remaining track for use beneath the scene.

Study a piano part

Extract piano from a mixed music recording to hear its phrasing more clearly. Treat the result as a listening aid and review passages with overlapping instruments.

Prepare a vocal editing reference

Separate singing from accompaniment for an editing reference. Avoid relying on it to identify one singer within a chorus.

Collect recorded sound effects

Extract a specific event, such as an engine revving or a horn honking, from a location recording for a sound editing session.

Separate music from spoken content

Target background music in a mixed recording and review the remaining track for a speech-focused edit.

Questions about SAM Audio in Factory Droid

Can Factory Droid use SAM Audio?

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

How much does SAM Audio cost in Factory Droid?

$0.065 per 30 seconds of audio, at least 30 seconds. Each extra reranking candidate: $0.0325 per 30 seconds. 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 SAM Audio in Factory Droid?

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

How long does it take to set up SAM Audio in Factory Droid?

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

Does Factory Droid wait while SAM Audio runs?

SAM Audio runs in the background. Factory Droid starts the run, checks on it and gives you the audio when it's ready.

What is SAM Audio useful for?

SAM Audio extracts a described sound from a mixed recording. Use it to isolate speech, music, or everyday sound effects for editing and review.

How should I describe the sound I want?

Use a short, lowercase phrase naming the source and its action, such as “piano playing” or “dog barking.” Meta recommends noun or verb phrases that match how the model was trained.

Can SAM Audio remove a sound instead of keeping it?

Yes. Describe the unwanted sound, then use the remaining-audio track, called the residual, for the edit.

What sounds are hardest to separate?

Highly similar sources remain difficult, such as one singer within a chorus or one instrument within an orchestra. Review those results before using them in a finished edit.

When should I try automatic sound timing?

Try it for distinct events, such as barking or honking, so the model predicts when the target occurs. Compare results with it disabled for continuous instrument parts: Meta reported a small decline in professional instrument separation.

Get started

Start using SAM Audio 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