[Integrations](https://spiral.ai/integrations) › [Google Antigravity](https://spiral.ai/integrations/antigravity) › [SAM Audio](https://spiral.ai/integrations/antigravity/sam-audio)

# How to Use SAM Audio in Google Antigravity

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 Google Antigravity

- 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 Google Antigravity

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

### Use Spiral's MCP server

1. **Open the MCP config**: * Antigravity App: click Customizations, then Installed. In the MCP Servers section, click Copy Config File Path and open that file. * Antigravity IDE: click … at the top of the agent side panel, select MCP Servers, then Manage MCP Servers › View raw config. * Antigravity CLI: edit `~/.gemini/config/mcp_config.json`.

2. **Add the server**: Add Spiral under `mcpServers`:

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

3. **Sign in**: In the Antigravity App, open Customizations › Installed. Under MCP Servers, click Authenticate next to Spiral. Sign in to Spiral, pick the organization and click Authorize. Copy the authorization code the browser shows, paste it into Enter authorization code and click Submit. No API key.

### Use the Spiral skill

1. **Send Google Antigravity 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: Google Antigravity finds SAM Audio on Spiral, shows the price and runs it.

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

## 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 Google Antigravity?

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 Google Antigravity guides](https://spiral.ai/integrations/antigravity)

## 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)
- [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)
- [Windsurf](https://spiral.ai/integrations/windsurf/sam-audio)
- [Zapier](https://spiral.ai/integrations/zapier/sam-audio)

## More Google Antigravity guides

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

## Questions about SAM Audio in Google Antigravity

**Can Google Antigravity use SAM Audio?**

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

**How much does SAM Audio cost in Google Antigravity?**

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

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

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 Google Antigravity?**

About two minutes: open the MCP config, then add the server, then sign in.

**Does Google Antigravity wait while SAM Audio runs?**

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

