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

# How to Use ACE-Step Audio Inpaint in opencode

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, no API key |

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

- Use ACE-Step Audio Inpaint on assets/audio/menu-theme.wav, editing 12–20 seconds. Request gentle piano, warm bass, restrained percussion, and instrumental music; save the audition beside the original.
- Read the project's music cue notes, then use ACE-Step Audio Inpaint on assets/audio/battle-demo.wav from 24–32 seconds. Request orchestral strings, heavy percussion, and tense instrumental music.
- Use ACE-Step Audio Inpaint on assets/audio/song-demo.wav from 30–38 seconds. Use the chorus revision in lyrics.md and the existing style notes, then save a separate audition.
- Use ACE-Step Audio Inpaint on assets/audio/podcast-theme.wav from 8–16 seconds. Request soft acoustic guitar and sparse piano without sung lyrics, then add the result to the project's audio comparison page.
- Use ACE-Step Audio Inpaint to make three auditions of 16–24 seconds in assets/audio/bridge-demo.wav. Request jazz piano, double bass, brushed drums, and instrumental music; compare variance values of 0.3, 0.5, and 0.7.

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

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 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: opencode finds ACE-Step Audio Inpaint on Spiral, shows the price and runs it.

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

## 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 opencode?

Audition changes to music already used in a game, app, or video project with ACE-Step Audio Inpaint. A coding agent can use project cue notes to select passages and organize the resulting auditions.

### 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 opencode guides](https://spiral.ai/integrations/opencode)

## 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)
- [dots](https://spiral.ai/integrations/dots/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)
- [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 opencode guides

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

## Questions about ACE-Step Audio Inpaint in opencode

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

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

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

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

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

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

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

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

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

ACE-Step Audio Inpaint runs in the background. opencode 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.

