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

Factory Droid · Audio

How to Use ACE-Step Audio Inpaint in Factory Droid

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.

Prompts to try with ACE-Step Audio Inpaint in Factory Droid

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

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.

ACE-Step Audio InpaintFactory Droid
Try asking
  • 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 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 ACE-Step Audio Inpaint

    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/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: Factory Droid finds ACE-Step Audio Inpaint on Spiral, shows the price and runs it.

ACE-Step Audio Inpaint providers and prices

Spiral runs ACE-Step Audio Inpaint through fal. Open a card for today's price, with every fee included.

falAudio
ACE Step Edit · Audio Inpaint
fal-ai/ace-step/audio-inpaint

Settings you can ask for

ACE-Step Audio Inpaint works from your audio URL. Ask Factory Droid for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Start time relative tostart or endstart

Whether the start time is relative to the start or end of the audio.

Start time0 to 2400

start time in seconds for the inpainting process.

End time relative tostart or endstart

Whether the end time is relative to the start or end of the audio.

End time0 to 24030

end time in seconds for the inpainting process.

Variance0 to 10.5

Variance for the inpainting process. Higher values can lead to more diverse results.

Number of steps3 to 6027

Number of steps to generate the audio.

Seeda whole number

Random seed for reproducibility. If not provided, a random seed will be used.

Schedulereuler or heuneuler

Scheduler to use for the generation process.

Guidance typecfg, apg, or cfg_starapg

Type of CFG to use for the generation process.

Granularity scale-100 to 10010

Granularity scale for the generation process. Higher values can reduce artifacts.

Guidance interval0 to 10.5

Guidance interval for the generation. 0.5 means only apply guidance in the middle steps (0.25 * infer_steps to 0.75 * infer_steps)

Guidance interval decay0 to 10

Guidance interval decay for the generation. Guidance scale will decay from guidance_scale to min_guidance_scale in the interval. 0.0 means no decay.

Guidance scale0 to 20015

Guidance scale for the generation.

Minimum guidance scale0 to 2003

Minimum guidance scale for the generation after the decay.

Tag guidance scale0 to 105

Tag guidance scale for the generation.

Lyric guidance scale0 to 101.5

Lyric guidance scale for the generation.

Every API field of ACE Step Edit · Audio Inpaint is on its tool page: open its card above.

What can you do with ACE-Step Audio Inpaint in Factory Droid?

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.

Questions about ACE-Step Audio Inpaint in Factory Droid

Can Factory Droid use ACE-Step Audio Inpaint?

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

How much does ACE-Step Audio Inpaint cost in Factory Droid?

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

Do I need a fal account to use ACE-Step Audio Inpaint in Factory Droid?

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 Factory Droid?

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

Does Factory Droid wait while ACE-Step Audio Inpaint runs?

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

Get started

Start using ACE-Step Audio Inpaint 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