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

opencode · AudioReleased 2025-05-06

How to Use ACE-Step Lyrics to Audio in opencode

ACE-Step Lyrics to Audio turns written lyrics and a musical brief into song drafts up to four minutes long. Unlike ACE-Step Audio to Audio, it creates music without a reference recording.

Prompts to try with ACE-Step Lyrics to Audio in opencode

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

Read the game's audio brief and use ACE-Step Lyrics to Audio to create a 60-second instrumental menu theme with piano, soft strings, and a calm mood. Use [inst] for the lyrics and save the take with the prototype's audio assets.

ACE-Step Lyrics to Audioopencode
Try asking
  • Use ACE-Step Lyrics to Audio to make a 30-second instrumental backing track for the product demo described in this repository. Keep the musical brief focused on light percussion and acoustic guitar, and use [instrumental] for the lyrics.

  • Read the song lyrics in the project and use ACE-Step Lyrics to Audio to create a 90-second demo. Preserve the words, mark the verse and chorus, and request an acoustic folk arrangement.

  • Compose a 30-second upbeat lo-fi track with ACE-Step Lyrics to Audio for a product video. Save the result in ./assets.

  • Make a calm piano loop with ACE-Step Lyrics to Audio for a meditation app.

How to set up ACE-Step Lyrics to Audio 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.

    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.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    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.

    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 Lyrics to Audio

    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",
        "input": {
          "tags": "lofi, hiphop, drum and bass, trap, chill"
        }
      }'

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

ACE-Step Lyrics to Audio providers and prices

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

falAudio

Settings you can ask for

Ask opencode for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Duration5 to 24060

The duration of the generated audio in seconds.

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 · Lyrics to Audio is on its tool page: open its card above.

What can you do with ACE-Step Lyrics to Audio in opencode?

Turn a project's music briefs into playable drafts for games, demos, and other prototypes. Use ACE-Step takes to compare musical directions alongside the scenes or features they accompany.

Songwriting demos

Audition a verse and chorus as a new song, or revise an existing demo to compare another lyrical or musical direction.

Podcast theme drafts

Create an instrumental theme from a brief, or remix an existing theme recording to explore a different treatment.

Game soundtrack sketches

Explore music for a menu, quiet exploration scene, or tense encounter. Start with a written brief or an existing music sketch, then audition the result against the scene.

Short video backing

Draft instrumental backing for a product demonstration or travel edit, either from a musical description or by remixing an existing cue.

Lyric delivery experiments

Hear how written lines sound in a new song or an edited recording. Compare phrasing and pronunciation before choosing a take.

Complete song drafts

Turn a musical brief and sectioned lyrics into a song draft lasting up to four minutes.

Questions about ACE-Step Lyrics to Audio in opencode

Can opencode use ACE-Step Lyrics to Audio?

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

How much does ACE-Step Lyrics to Audio cost in opencode?

$0.00026 per second. Billed on `duration`, default 60. 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 Lyrics to Audio in opencode?

No. Spiral runs ACE-Step Lyrics to 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 ACE-Step Lyrics to Audio in opencode?

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

Does opencode wait while ACE-Step Lyrics to Audio runs?

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

What is ACE-Step useful for?

Use ACE-Step to audition song ideas, instrumental backing, and alternate musical treatments. It is a practical choice for drafts you can listen to and revise before committing to a production.

How should I write an ACE-Step music brief?

Keep the musical description separate from the words to be sung. Start with a focused brief such as acoustic folk, guitar, gentle percussion, and a restrained vocal, then place the lyrics in their own section.

Can ACE-Step make instrumentals?

Yes. Use [instrumental] or [inst] in place of sung lyrics, and describe the instrumentation and mood in the musical brief.

How do I indicate song sections?

Place [verse], [chorus], and [bridge] before the corresponding lyrics. Treat these as structural guidance and listen to the result before assuming the arrangement follows every instruction.

Does ACE-Step perform equally well in every language?

No. The model card says performance varies by language and is strongest in its top ten languages, so audition pronunciation before using a take.

Get started

Start using ACE-Step Lyrics to Audio in opencode

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

Paste this into opencode:

Set up opencode

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