How to Use Lyria 3 Pro in Windsurf
Lyria 3 Pro makes songs up to three minutes, with room for verses, choruses, bridges, and timed lyrics. Choose it when a musical idea needs to develop beyond Lyria 3's 30-second clip.
Prompts to try with Lyria 3 Pro in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use the original chorus lyrics in the project notes with Lyria 3 Pro to draft a song up to three minutes long. Ask for acoustic pop, a clear English tenor, an intimate verse, and a fuller chorus.
Use the game's final scene notes to brief Lyria 3 Pro for an instrumental track up to three minutes. Start with quiet piano, introduce strings, and build toward a hopeful orchestral ending.
Compose a 30-second upbeat lo-fi track with Lyria 3 Pro for a product video. Save the result in ./assets.
Make a calm piano loop with Lyria 3 Pro for a meditation app.
Create a cinematic 20-second intro sting with Lyria 3 Pro.
How to set up Lyria 3 Pro in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf 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 Lyria 3 Pro
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/lyria3/pro", "input": { "prompt": "An energetic electronic dance track with soaring synth leads, punchy four-on-the-floor kick drums, and a catchy vocal hook singing '\''Feel the rhythm, feel the…" } }'
Then paste one of the prompts above: Windsurf finds Lyria 3 Pro on Spiral, shows the price and runs it.
Lyria 3 Pro providers and prices
Spiral runs Lyria 3 Pro through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Lyria 3 Pro works from your prompt and image URL. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Negative prompt | what to leave out, in words | Negative prompting is not supported by Lyria 3. |
Every API field of Lyria 3 Pro is on its tool page: open its card above.
What can you do with Lyria 3 Pro in Windsurf?
Turn a game's scene notes or a video's project brief into music you can audition alongside the work. Have the coding agent translate those notes into a clear description of mood, instruments, pace, and vocals.
Short video music
Draft a soundtrack for a 30-second cooking, travel, or product video. Describe the scene's energy, the main instruments, and whether the music should include singing.
Podcast opening themes
Create an instrumental opening theme with a clear musical identity, such as brushed drums and upright bass for a conversational interview show.
Tutorial backing music
Draft a restrained instrumental cue for a tutorial opening or demonstration segment. Ask for sparse piano, a gentle pulse, and subdued dynamics.
Game scene music
Explore music for a game menu, village scene, or victory sequence. Define the setting through instrumentation, pace, and mood.
Songwriting sketches
Hear how a lyrical idea might work as acoustic pop, jazz, or electronic music. Supply a short original lyric and describe the singer's delivery.
Personal musical greetings
Make a birthday or thank-you song around a specific memory. Choose a supported singing language and describe the recipient's preferred musical style.
Music inspired by artwork
Use an illustration or photograph as inspiration for an instrumental track. Add musical directions that connect its setting and mood to particular instruments.
Complete song drafts
Develop a song with an intro, verses, a recurring chorus, and a contrasting bridge within three minutes. Describe how the arrangement should build and resolve.
More on Lyria 3 Pro and Windsurf
Overview
Lyria 3 Pro in other agents
Questions about Lyria 3 Pro in Windsurf
Can Windsurf use Lyria 3 Pro?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Lyria 3 Pro like any built-in tool.
How much does Lyria 3 Pro cost in Windsurf?
$0.104 per run at the default inputs. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.
Do I need a fal account to use Lyria 3 Pro in Windsurf?
No. Spiral runs Lyria 3 Pro on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Lyria 3 Pro in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Lyria 3 Pro runs?
Lyria 3 Pro runs in the background. Windsurf starts the run, checks on it and gives you the audio when it's ready.
How long are Lyria 3 tracks?
Lyria 3 generates 30-second clips. Lyria 3 Pro supports songs up to three minutes, giving an arrangement more room to develop.
Can Lyria 3 make instrumental music and songs with lyrics?
Yes. Ask for instrumental music to leave out singing, or describe a vocal style and lyrical theme. You can also supply your own lyrics.
Which singing languages does Lyria 3 support?
English, German, Spanish, French, Hindi, Japanese, Korean, and Portuguese. Name the language alongside the vocal tone and delivery you want.
What should a useful Lyria 3 prompt include?
Specify the genre, mood, main instruments, pace, and vocal direction. For example, ask for a relaxed jazz instrumental with upright bass, brushed drums, and soft piano.
What audio format does Lyria 3 produce?
Lyria 3 and Lyria 3 Pro produce MP3 audio at 44.1 kHz and 192 kbps.
Start using Lyria 3 Pro in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


