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

Hermes · Audio

How to Use ACE-Step Audio Inpaint in Hermes

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 Hermes

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

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.

ACE-Step Audio InpaintHermes
Try asking
  • 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 Hermes

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

Use the Spiral skill

  1. Send Hermes 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. Add the server and sign in

    Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

    hermes mcp add spiral \
      --url https://api.spiral.ai/mcp \
      --auth oauth \
      --connect-timeout 300
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

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: Hermes 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 Hermes 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 Hermes?

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.

Questions about ACE-Step Audio Inpaint in Hermes

Can Hermes use ACE-Step Audio Inpaint?

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

How much does ACE-Step Audio Inpaint cost in Hermes?

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

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

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 Hermes?

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

Does Hermes wait while ACE-Step Audio Inpaint runs?

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

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Hermes:

Set up Hermes

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options