[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [SAM Audio](https://spiral.ai/integrations/windsurf/sam-audio)

# How to Use SAM Audio in Windsurf

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.

|  |  |
| --- | --- |
| Model | SAM Audio |
| Available through | fal |
| Category | Audio |
| Price | $0.065 per 30 seconds of audio, at least 30 seconds. Each extra reranking candidate: $0.0325 per 30 seconds. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with SAM Audio in Windsurf

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

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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.

```bash
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.

```bash
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: Windsurf finds SAM Audio on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/windsurf

## SAM Audio tools and prices

- [SAM Audio · Text-Prompted Sound Separation](https://spiral.ai/tools/fal/fal-ai/sam-audio/separate) (fal): $0.065 per 30 seconds of audio, at least 30 seconds. Each extra reranking candidate: $0.0325 per 30 seconds.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| predict_spans |  | false | Automatically predict temporal spans where the target sound occurs. |
| reranking_candidates | 1 to 7 | 1 | Number of candidates to generate and rank. Higher improves quality but increases latency and cost. |
| acceleration | fast, balanced, quality | balanced | The acceleration level to use. |
| max_chunk_duration | 10 to 60 | 60 | Maximum audio duration (in seconds) to process in a single pass. Longer audio will be chunked with overlap and blended. |
| chunk_overlap | 0 to 30 | 5 | Overlap duration (in seconds) between chunks for crossfade blending. |
| output_format | wav, mp3 | wav | Output audio format. |

## What can you do with SAM Audio in Windsurf?

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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## SAM Audio in other agents

- [Amp](https://spiral.ai/integrations/amp/sam-audio)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/sam-audio)
- [Claude](https://spiral.ai/integrations/claude-desktop/sam-audio)
- [Claude Code](https://spiral.ai/integrations/claude-code/sam-audio)
- [Cline](https://spiral.ai/integrations/cline/sam-audio)
- [Codex](https://spiral.ai/integrations/codex/sam-audio)
- [Cursor](https://spiral.ai/integrations/cursor/sam-audio)
- [Devin](https://spiral.ai/integrations/devin/sam-audio)
- [dots](https://spiral.ai/integrations/dots/sam-audio)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/sam-audio)
- [Gemini](https://spiral.ai/integrations/gemini/sam-audio)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/sam-audio)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/sam-audio)
- [goose](https://spiral.ai/integrations/goose/sam-audio)
- [Grok](https://spiral.ai/integrations/grok/sam-audio)
- [Grok Build](https://spiral.ai/integrations/grok-build/sam-audio)
- [Hermes](https://spiral.ai/integrations/hermes/sam-audio)
- [Instinct](https://spiral.ai/integrations/instinct/sam-audio)
- [Manus](https://spiral.ai/integrations/manus/sam-audio)
- [Muse](https://spiral.ai/integrations/muse/sam-audio)
- [Muse Code](https://spiral.ai/integrations/muse-code/sam-audio)
- [n8n](https://spiral.ai/integrations/n8n/sam-audio)
- [Notion](https://spiral.ai/integrations/notion/sam-audio)
- [OpenClaw](https://spiral.ai/integrations/openclaw/sam-audio)
- [opencode](https://spiral.ai/integrations/opencode/sam-audio)
- [Perplexity](https://spiral.ai/integrations/perplexity/sam-audio)
- [Raycast](https://spiral.ai/integrations/raycast/sam-audio)
- [VS Code](https://spiral.ai/integrations/vscode/sam-audio)
- [Zapier](https://spiral.ai/integrations/zapier/sam-audio)

## More Windsurf guides

- [Qwen3-TTS 1.7B Voice Design](https://spiral.ai/integrations/windsurf/qwen3-tts-1-7b-voice-design)
- [SAM Audio Visual Separation](https://spiral.ai/integrations/windsurf/sam-audio-visual-separation)
- [Qwen3-TTS 1.7B](https://spiral.ai/integrations/windsurf/qwen3-tts-1-7b)
- [Scribe v2](https://spiral.ai/integrations/windsurf/scribe-v2)
- [Qwen3-TTS 0.6B Clone Voice](https://spiral.ai/integrations/windsurf/qwen3-tts-0-6b-clone-voice)
- [Scribe v3](https://spiral.ai/integrations/windsurf/scribe-v3)

## Questions about SAM Audio in Windsurf

**Can Windsurf use SAM Audio?**

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

**How much does SAM Audio cost in Windsurf?**

$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 Windsurf plan is separate.

**Do I need a fal account to use SAM Audio in Windsurf?**

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 Windsurf?**

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

**Does Windsurf wait while SAM Audio runs?**

SAM Audio runs in the background. Windsurf 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.

