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

Windsurf · AudioReleased 2026-02-18

How to Use Lyria 3 in Windsurf

Lyria 3 makes 30-second music clips for short videos, podcast intros, and song sketches, with vocals or instrumental arrangements. Choose it for a compact musical idea; Lyria 3 Pro supports songs up to three minutes.

Prompts to try with Lyria 3 in Windsurf

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

Read the game's village scene notes and use Lyria 3 to generate a 30-second instrumental sketch. Use acoustic guitar, wooden flute, and light hand percussion at a relaxed walking pace.

Lyria 3Windsurf
Try asking
  • Use the product demo script in this project to brief Lyria 3 for a 30-second instrumental cue. Ask for muted synth plucks, soft bass, a steady moderate beat, and a curious mood.

  • Read the podcast brief and use Lyria 3 to create a 30-second opening theme with upright bass, brushed drums, and warm piano. Make it instrumental with a relaxed jazz feel.

  • Compose a 30-second upbeat lo-fi track with Lyria 3 for a product video. Save the result in ./assets.

  • Make a calm piano loop with Lyria 3 for a meditation app.

How to set up Lyria 3 in Windsurf

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

Use Spiral's MCP server

  1. 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"
        }
      }
    }
  2. 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
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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 Lyria 3

    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",
        "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 on Spiral, shows the price and runs it.

Lyria 3 providers and prices

Spiral runs Lyria 3 through fal. Open a card for today's price, with every fee included.

falAudio
Lyria 3
fal-ai/lyria3

Settings you can ask for

Lyria 3 works from your prompt and image URL. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Negative promptwhat to leave out, in words

Negative prompting is not supported by Lyria 3.

Every API field of Lyria 3 is on its tool page: open its card above.

What can you do with Lyria 3 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.

Questions about Lyria 3 in Windsurf

Can Windsurf use Lyria 3?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Lyria 3 like any built-in tool.

How much does Lyria 3 cost in Windsurf?

$0.052 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 in Windsurf?

No. Spiral runs Lyria 3 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 in Windsurf?

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

Does Windsurf wait while Lyria 3 runs?

Lyria 3 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.

Get started

Start using Lyria 3 in Windsurf

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

Paste this into Windsurf:

Set up Windsurf

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