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.
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
- 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
- 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
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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.
Settings you can ask for
Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Duration | 5 to 240 | 60 | The duration of the generated audio in seconds. |
| Number of steps | 3 to 60 | 27 | Number of steps to generate the audio. |
| Seed | a whole number | Random seed for reproducibility. If not provided, a random seed will be used. | |
| Scheduler | euler or heun | euler | Scheduler to use for the generation process. |
| Guidance type | cfg, apg, or cfg_star | apg | Type of CFG to use for the generation process. |
| Granularity scale | -100 to 100 | 10 | Granularity scale for the generation process. Higher values can reduce artifacts. |
| Guidance interval | 0 to 1 | 0.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 decay | 0 to 1 | 0 | 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 scale | 0 to 200 | 15 | Guidance scale for the generation. |
| Minimum guidance scale | 0 to 200 | 3 | Minimum guidance scale for the generation after the decay. |
| Tag guidance scale | 0 to 10 | 5 | Tag guidance scale for the generation. |
| Lyric guidance scale | 0 to 10 | 1.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.
More on ACE-Step Lyrics to Audio and opencode
Overview
ACE-Step Lyrics to Audio in other agents
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.
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 https://spiral.ai/SKILL.md


