[Integrations](https://spiral.ai/integrations) › [dots](https://spiral.ai/integrations/dots) › [ACE-Step Audio Inpaint](https://spiral.ai/integrations/dots/ace-step-audio-inpaint)

# How to Use ACE-Step Audio Inpaint in dots

ACE-Step Audio Inpaint regenerates a selected passage in existing music using style descriptions or lyrics. Use it to try a different chorus, vocal phrase, or instrumental passage while retaining the surrounding audio.

|  |  |
| --- | --- |
| Model | ACE-Step Audio Inpaint |
| Available through | fal |
| Category | Audio |
| Price | Up to $0.0156 per run at the default inputs for 60 seconds of input. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with ACE-Step Audio Inpaint in dots

- Every Monday, use ACE-Step Audio Inpaint on each supplied podcast theme with a marked narration passage. Request sparse piano, soft bass, and no sung lyrics within that passage; collect the auditions for review.
- Each morning, use ACE-Step Audio Inpaint on submitted song demos that include revised chorus lyrics and edit timestamps. Apply the supplied wording within the marked passage and retain the stated musical style.
- Every Friday, use ACE-Step Audio Inpaint to make three auditions of each marked instrumental break in the submitted demos. Follow the supplied genre and instrument brief and request moderate variation.
- Each week, use ACE-Step Audio Inpaint on the supplied game cue from 24–32 seconds. Request tense strings, low percussion, and no sung lyrics; collect two auditions for the composer.
- Every Tuesday, use ACE-Step Audio Inpaint on submitted musical ad demos with an approved replacement line and marked timestamps. Request the stated vocal character and collect the edited demos for lyric and timing review.

## How to set up ACE-Step Audio Inpaint in dots

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

### Use the Spiral skill

1. **Send dots 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for your dot. Copy it.

2. **Send your dot this message**: Your dot reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give your dot the key**: When your dot asks for the key, add it where your dot keeps secrets, never in the chat itself.

### 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 ACE-Step Audio Inpaint**: 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/ace-step/audio-inpaint",
    "input": {
      "audio_url": "https://storage.googleapis.com/falserverless/example_inputs/ace-step-audio-to-audio.wav",
      "tags": "lofi, hiphop, drum and bass, trap, chill"
    }
  }'
```

Then paste one of the prompts above: dots finds ACE-Step Audio Inpaint on Spiral, shows the price and runs it.

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

## ACE-Step Audio Inpaint tools and prices

- [ACE Step Edit · Audio Inpaint](https://spiral.ai/tools/fal/fal-ai/ace-step/audio-inpaint) (fal): $0.00026 per second.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| start_time_relative_to | start, end | start | Whether the start time is relative to the start or end of the audio. |
| start_time | 0 to 240 | 0 | start time in seconds for the inpainting process. |
| end_time_relative_to | start, end | start | Whether the end time is relative to the start or end of the audio. |
| end_time | 0 to 240 | 30 | end time in seconds for the inpainting process. |
| lyrics |  |  | Lyrics to be sung in the audio. If not provided or if [inst] or [instrumental] is the content of this field, no lyrics will be sung. Use control structures like [verse], [chorus] and [bridge] to control the structure of the song. |
| variance | 0 to 1 | 0.5 | Variance for the inpainting process. Higher values can lead to more diverse results. |

## What can you do with ACE-Step Audio Inpaint in dots?

Prepare recurring auditions for marked passages in music demos with ACE-Step Audio Inpaint. A scheduled agent can apply supplied revision briefs and collect results for listening review.

### Audition a chorus rewrite

Try revised lyrics in the chorus of an existing song demo and compare the phrasing before committing to a rewrite.

### Rework an instrumental break

Regenerate a selected instrumental passage with a different musical direction, such as piano instead of a synth-led arrangement.

### Test a quieter podcast music bed

Try a gentler arrangement in the passage that sits beneath narration in an existing podcast theme.

### Explore a game music transition

Create alternative versions of a short passage in an existing game cue to audition a change in mood or intensity.

### Revise a sung campaign line

Test new wording in a selected phrase of an existing musical ad demo, then review intelligibility and timing.

### Compare vocal directions

Regenerate a short sung passage with different vocal descriptions to explore how the performance changes.

## Overview

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

## ACE-Step Audio Inpaint in other agents

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

## More dots guides

- [xAI](https://spiral.ai/integrations/dots/xai)
- [ACE-Step Audio Outpaint](https://spiral.ai/integrations/dots/ace-step-audio-outpaint)
- [Vizard](https://spiral.ai/integrations/dots/vizard)
- [ACE-Step Audio to Audio](https://spiral.ai/integrations/dots/ace-step-audio-to-audio)
- [OpenAI](https://spiral.ai/integrations/dots/openai)
- [ACE-Step Lyrics to Audio](https://spiral.ai/integrations/dots/ace-step-lyrics-to-audio)

## Questions about ACE-Step Audio Inpaint in dots

**Can dots use ACE-Step Audio Inpaint?**

Yes. Add Spiral to dots as an MCP server, and dots can find and run ACE-Step Audio Inpaint like any built-in tool.

**How much does ACE-Step Audio Inpaint cost in dots?**

Up to $0.0156 per run at the default inputs for 60 seconds of input. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your dots plan is separate.

**Do I need a fal account to use ACE-Step Audio Inpaint in dots?**

You need no fal account. dots uses one Spiral API key for every tool, and Spiral runs ACE-Step Audio Inpaint on its own fal account.

**How long does it take to set up ACE-Step Audio Inpaint in dots?**

About two minutes: create an API key, then send your dot this message, then give your dot the key.

**Does dots wait while ACE-Step Audio Inpaint runs?**

ACE-Step Audio Inpaint runs in the background. dots starts the run, checks on it and gives you the audio when it's ready.

**What can ACE-Step Audio Inpaint change?**

It can regenerate a selected passage using new lyrics or a style description. Useful targets include a chorus, a vocal phrase, or an instrumental passage.

**Does ACE-Step Audio Inpaint preserve the surrounding song?**

Repainting is designed to preserve audio outside the selected region. Listen across both edit boundaries before accepting a result.

**What should I put in the style description?**

Specify the genre, main instruments, approximate tempo, mood, and desired vocal character. For example: acoustic folk, fingerpicked guitar, 90 BPM, gentle, soft vocals.

**Can ACE-Step Audio Inpaint make an instrumental passage?**

Yes. Use [inst] or [instrumental] to request a passage without sung lyrics, and describe the instruments and mood separately.

**How consistent are repeated edits?**

The maker reports strong sensitivity to random seeds and input duration. Compare several attempts on the same passage before changing the edit boundaries.

