[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Lyria 3](https://spiral.ai/integrations/windsurf/lyria-3)

# 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.

|  |  |
| --- | --- |
| Model | Lyria 3 |
| Available through | fal |
| Category | Audio |
| Price | $0.052 per run at the default inputs. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Lyria 3 in Windsurf

- 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.
- 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:

```json
{
  "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.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
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.

```bash
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.

```bash
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.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/windsurf

## Lyria 3 tools and prices

- [Lyria 3](https://spiral.ai/tools/fal/fal-ai/lyria3) (fal): $0.052 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| negative_prompt |  |  | Negative prompting is not supported by Lyria 3. |
| image_url |  | — | Optional image URL to use as inspiration for music generation. The model will create music that matches the mood and theme of the image. |

## 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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## Lyria 3 in other agents

- [Amp](https://spiral.ai/integrations/amp/lyria-3)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/lyria-3)
- [Claude](https://spiral.ai/integrations/claude-desktop/lyria-3)
- [Claude Code](https://spiral.ai/integrations/claude-code/lyria-3)
- [Cline](https://spiral.ai/integrations/cline/lyria-3)
- [Codex](https://spiral.ai/integrations/codex/lyria-3)
- [Cursor](https://spiral.ai/integrations/cursor/lyria-3)
- [Devin](https://spiral.ai/integrations/devin/lyria-3)
- [dots](https://spiral.ai/integrations/dots/lyria-3)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/lyria-3)
- [Gemini](https://spiral.ai/integrations/gemini/lyria-3)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/lyria-3)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/lyria-3)
- [goose](https://spiral.ai/integrations/goose/lyria-3)
- [Grok](https://spiral.ai/integrations/grok/lyria-3)
- [Grok Build](https://spiral.ai/integrations/grok-build/lyria-3)
- [Hermes](https://spiral.ai/integrations/hermes/lyria-3)
- [Instinct](https://spiral.ai/integrations/instinct/lyria-3)
- [Manus](https://spiral.ai/integrations/manus/lyria-3)
- [Muse](https://spiral.ai/integrations/muse/lyria-3)
- [Muse Code](https://spiral.ai/integrations/muse-code/lyria-3)
- [n8n](https://spiral.ai/integrations/n8n/lyria-3)
- [Notion](https://spiral.ai/integrations/notion/lyria-3)
- [OpenClaw](https://spiral.ai/integrations/openclaw/lyria-3)
- [opencode](https://spiral.ai/integrations/opencode/lyria-3)
- [Perplexity](https://spiral.ai/integrations/perplexity/lyria-3)
- [Raycast](https://spiral.ai/integrations/raycast/lyria-3)
- [VS Code](https://spiral.ai/integrations/vscode/lyria-3)
- [Zapier](https://spiral.ai/integrations/zapier/lyria-3)

## More Windsurf guides

- [Kotoba STT](https://spiral.ai/integrations/windsurf/kotoba-stt)
- [Lyria 3 Pro](https://spiral.ai/integrations/windsurf/lyria-3-pro)
- [Kokoro TTS Spanish](https://spiral.ai/integrations/windsurf/kokoro-tts-spanish)
- [Lyria 3.5](https://spiral.ai/integrations/windsurf/lyria-3-5)
- [Kokoro Mandarin Chinese](https://spiral.ai/integrations/windsurf/kokoro-mandarin-chinese)
- [MMAudio V2 Text to Audio](https://spiral.ai/integrations/windsurf/mmaudio-v2-text-to-audio)

## 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.

